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Related Documents 



In addition to this guide, you might be 
interested in four other related documents: 



Tu rboDQS i^ .^M 



LinjDer's gujde 



. TurboDQg 1^ ZM. Unplsmento r's Guide 
. TurboDOS 1^ 8086 Progra mm er's Guide 



TurboDOS 1.4 8086 Im plem i 



Guide 



You'll need the Progra mm er's Guide if you are 
writing applications programs to run under 
TurboDOS, especially if you are programming 
in assembly language. It explains the inter- 
nal workings of TurboDOS in much more detail 
than this document does, and describes each 
TurboDOS function in detail. 

You'll need the Implemento r' s GJiiii^ if you 
are adapting TurboDOS to a new hardware con- 
figuration. It explains the system genera- 
tion and OEM distribution procedures, and 
also describes how to implement hardware- 
dependent driver modules. 
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ABOUT THIS GUIDE 
Purpose 



We've designed this User's Ggj^e to make it 
easy for you to learn how to use the TurboDOS 
operating system. This document tells you 
what TurboDOS does, how to use its various 
facilities, and what to do in case of errors. 
It also describes each TurboDOS command in 
detail. The information presented applies 
to both Z80 and 8086 TurboDOS. 



Assumptions 



In writing this guide, we've assumed that you 
have a pre-conf igured copy of TurboDOS all 
ready to run on your computer. Also, you 
need to know some basic things about your 
computer equipment: how to hook it up and 
start it running, and how to handle the disks 
it uses. We haven't assumed you are a pro- 
grammer or an experienced computer user, 
however. 



Organization 



This guide starts with a section that ex- 
plains some of the basics: what TurboDOS is, 
what it does, how to get it started, enter 
commands, and correct errors. 

The next three sections explain the principal 
concepts of TurboDOS in more detail. There 
are sections on files and disks, printing, 
and processing. 

There is a reference section that describes 
each TurboDOS command in detail. This sec- 
tion is organized alphabetically for easy 
reference. 

Finally, there is a glossary and an index. 
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SOME BASICS 



In this section you will learn what TurboDOS 
does, what kind of hardware it runs on, how 
to start it up, and how to enter commands and 
correct errors. 

Let's start with the obvious question... 



What is TurboDOS? 



TurboDOS is a collection of programs designed 
to make your computer run more efficiently, 
and to make it easier for you to run other 
programs, create and manage files, and use 
the peripheral devices (such as the console, 
printer, and disk drives) attached to your 
computer . 

TurboDOS is an "operating system", the tech- 
nical term for a program which supervises the 
operation of other programs. TurboDOS itself 
is not specialized for any particular appli- 
cation (such as word processing, accounting, 
or statistics). Instead, TurboDOS works 
together with whatever specialized applica- 
tion program you care to run, and takes care 
of whatever file and device management func- 
tions your particular application program 
requests. 

Now let's examine what makes TurboDOS dif- 
ferent from other operating systems. 



Why Use TurboDOS? 



Compared to other microcomputer operating 
systems, TurboDOS is distinguished by: 



Networking Capability 

CP/M and PC-DOS Compatibility 

Superior Performance 

Increased Disk Capacity 

Enhanced Reliability 

Print Spooling 



We'll begin with networking. 
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Inc. 



Networking 



Compared with other operating systems, Turbo- 
DOS perhaps is most distinguished by its 
ability to coordinate a "network" of inter- 
connected microcomputers. Generally, a sepa- 
rate microcomputer supports each user's video 
console. One or more additional microcompu- 
ters manage the disks, printers, and other 
shared devices of the system. 

Since this approach provides a microcomputer 
dedicated to each user, TurboDOS is able to 
support a large number of simultaneous users 
with excellent performance and minimal inter- 
action. You will discover this networking 
approach offers far better performance and 
reliability than does any system that relies 
on "time-sharing" one processor among many 
users. 



CP/M and PC-DOS 
Compatibility 



TurboDOS lets you run any program designed to 
operate with the popular CP/M and MP/M opera- 
ting systems from Digital Research. This 
means that you can choose from a vast library 
of available software packages: financial 
applications, word processors, spelling 
checkers, spreadsheets, language processors, 
and programming tools. 

TurboDOS runs virtually any CP/M program 
without modification, and accepts standard 
CP/M-format disks. TurboDOS is fully compa- 
tible with CP/M-80 2.2 and CP/M-86 1.1. In 
addition, TurboDOS provides compatibility 
with CP/M Plus, MP/M II, Concurrent CP/M-86, 
and MP/M-86 in file and record locks, queues, 
system date and time, and many other func- 
tions. 

8086 TurboDOS also includes an emulator for 
IBM Personal Computer DOS that allows many 
programs written for PC-DOS to be run under 
TurboDOS. 
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Performance Independent benchmark comparisons have shown 

that file-intensive applications perform much 
better with TurboDOS than with CP/M or MP/M. 
You'll benefit from this performance improve- 
ment with virtually any business application. 
File processing averages at least three times 
as fast, sometimes much more. The more users 
on your system, the greater the performance 
advantage becomes. 



Disk Capacity Business applications are often limited by 

the available disk capacity of your computer. 
TurboDOS lets you store 25% to 35% more data 
on each floppy disk, compared to most CP/M 
systems. This is achieved by using a more 
efficient format for storing data on disk. 
Standard-format CP/M disks are also accomo- 
dated by TurboDOS, of course, but they hold 
less data and run quite a bit slower. 

For bigger requirements, TurboDOS is designed 
to handle big hard disks and big files. CP/M 
has internal limitations which prevent it 
from supporting disks or files larger than 8 
megabytes. Disk drives larger than 8 mega- 
bytes have to be partitioned into segments, 
making them awkward to use. In contrast, 
TurboDOS supports disk drives to 1,000+ mega- 
bytes without partitioning, and supports 
files up to 134 megabytes. 



Reliability Integrity of data and graceful recovery from 

errors are critical to any serious data pro- 
cessing activity. TurboDOS offers vital 
improvements in these important areas. 

TurboDOS does read-af ter-wri te of all disk 
updates. In other words, whenever it writes 
information out to disk, it immediately reads 
it back to make sure it got recorded okay. 
(Most microcomputers don't do thisl) 
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Reliability VVhenever errors are detected, TurboDOS gives 
(Continued) you meaningful diagnostic messages, and lets 

you chose from a variety of recovery options. 
In the event of a disk error, for example, 
you can choose one of these alternatives: 

. Retry the disk operation again 

. Ignore the error and continue processing 

. Abort the program 

In multi-user networking systems, TurboDOS 
incorporates an advanced failure detection 
and recovery facility that makes your system 
virtually crashproof. Even a malicious user 
cannot compromise the processing or files 
belonging to another user. 

Print Spooling The slowest component of your computer system 

is undoubtedly the printer. If your applica- 
tions involve much printing, you may find 
that the printer is the bottleneck that 
limits how much work you can get done on your 
system. To help solve this problem, TurboDOS 
includes an automatic "print spooling" faci- 
lity that lets you get on with the next 
processing task without having to wait for 
printing from the previous task to finish. 

Here's how it works. When your application 
program tries to send characters to the 
printer, TurboDOS intercepts them and saves 
them in a disk file instead. (This is called 
"spooling".) When the program is done, 
TurboDOS automatically starts printing the 
contents of the file. (This is called "de- 
spooling".) At the same time, it lets you go 
ahead and run your next program. 

In a multi-user system, several users may try 
to print at the same time. In this case, 
TurboDOS automatically queues the print files 
on a first-come first-served basis. 
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Hardware Needed At this point, let's take a look at what kind 

of hardware TurboDOS can support, both multi- 
processor and single-processor. 



Multi-Processor Since today's microcomputers fit on a single 

small circuit board, an elaborate networking 
system with five or ten processors can be 
housed in a small desk-top enclosure. Alter- 
natively, the processors can be built into 
the user consoles and connected together with 
some sort of electrical cable. We call these 
"tightly-coupled" and "loosely-coupled" net- 
works, respectively. TurboDOS supports both. 

Single-Processor Single-user versions of TurboDOS are also 

available, both with and without print spool- 
ing capability. You'll find TurboDOS to be 
faster and more capable than other single- 
user operating systems. 

TurboDOS is not available in a "time-sharing" 
version (multiple users sharing a single 
processor) . 



Memory Size The 8-bit processors should have 64K (kilo- 
bytes) of random access memory (RAM). Two 
banks of 64K (a total of 128K) is very desir- 
able for applications which require a lot of 
memory. 

The 16-bit processors should have at least 
128K of RAM, preferably more (up to the maxi- 
mum of one megabyte). The memory need not be 
contiguously addressed. 
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Getting Started To get TurboDOS started, it is necessary to 

read a copy of the operating system from your 
TurboDOS system disk into your computer's 
memory. This process is variously known as 
"cold start". 



Cold Start The exact cold-start procedure depends on the 

kind of hardware you are using. 

Usually, all you need to do is turn on the 
computer's power switch, or press the compu- 
ter's "reset" button (if the power is already 
on). If your TurboDOS system disk is a flop- 
py disk or other type of removable media, you 
need to load it into the disk drive. At this 
point, TurboDOS will load into memory automa- 
tically, and sign on. See "Installation 
Guide." 



Sign On On a single-user system (or a multi-user 

system with no log-on required), you will see 
the following display on your console as soon 
as TurboDOS is loaded: 



I TurboDOS 1.4x, Copyright 1984 etc. 
I OA} 



The "sign-on" message tells you which version 
of TurboDOS you are using. The "OA}" is 
the "command prompt" that tells you TurboDOS 
is ready to accept a command from your 
keyboard. It also tells you that user number 
zero and drive A are currently selected (more 
about this later) . 

Multi-user systems usually require you to 
identify yourself before you may proceed. 
Let's see how this is done. 
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Log On 



On most multi-user systems, you must "log on" 
by entering a valid user identification, 
password, and possibly other information: 



TurboDOS 1.4x, Copyright 1984 etc. 

System log on 

Enter user id: BARBARA 

Enter password: SHAZAM 

Enter activity: PAYROLL 

5A} 



In the example above (and throughout the 
rem.ainder of this document), underlines are 
used to indicate the items you need to key 
in. The rest is displayed by TurboDOS. 
After you have typed each response, you have 
to press the RETURN (or ENTER) key on your 
keyboard before TurboDOS will process the 
item. 

The v;ay TurboDOS validates user id's and 
passwords is described later on (see the 
details of the LOGON command). The date and 
time are not requested if the system clock 
was previously set. The activity description 
is requested only if a system log file has 
been set up. 

As soon as you get through the log-on proce- 
dure successfully, TurboDOS displays its 
"command prompt" to let you know it's ready 
to accept your first command. Remember that 
the "5A}" prompt tells you that user number 5 
and drive A are currently selected. 

Next, we'll learn how to enter commands. 
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Entering Commands 



Command Format 



TurboDOS does only what you tell it to do. 
The way you tell it what to do is by entering 
commands on your console keyboard. 

Whenever you enter a command, you are actual- 
ly asking TurboDOS to load a particular pro- 
gram from disk into your computer's memory 
and run it. TurboDOS comes with more than 30 
standard commands (programs) that are de- 
scribed in detail in a later section of this 
guide. You can also enter commands to run 
application programs, or programs you have 
written yourself. 



A TurboDOS command always contains a command 
name which specifies the program to be run. 
The simplest commands consist only of the 
command name, followed by the RETURN (or 
ENTER) key. For example: 



OAlDIE 



is a commonly-used command which displays a 
directory of the files on the currently- 
selected user number (zero) and disk drive 
(drive A). Remember that the command name 
"DIR" is actually the name of a program on 
disk. Don't forget the RETURN key at the end 
of each command. 

Frequently, the command name is followed by 
additional command information (drive letter, 
file name, option, etc.) to be passed to the 
command program. For example: 



I OA} DIR B: 



displays the directory for drive B. 
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Command Format Another example: 
(Continued) 



I OAI CQPY A:ANYFILE B; 



is a command to copy a file named "ANYFILE" 
from drive A to drive B. "COPY" is the name 
of another command program. 



Multiple Commands You may enter several TurboDOS commands at 

one time. To do this, separate the commands 
with the character \ (backslant), and press 
RETURN after the last command. For example: 



I I 

I OA} DIR B;\DIR C:\DIR D: I 

I : I 

is a string of three commands to display the 
directories of drives B, C and D in sequence. 

You can string as many commands together as 
you like, limited only by the size of the 
TurboDOS command buffer. Normally, the com- 
mand buffer is big enough for you to type a 
command string two lines long. 

When you enter a string of commands, TurboDOS 
executes each command in sequence, one after 
another. Each command but the first is 
displayed on your console as it is executed. 
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Correcting Errors 



As you type characters on the keyboard, they 
appear on the screen of your console. An 
indicator called the "cursor" (usually a box 
or underline) shows you where the next char- 
acter will appear. 

If you make a typing mistake and you notice 
it before you press RETURN, you can correct 
it easily. Use the BACKSPACE or DEL key to 
delete the incorrect character(s) and move 
the cursor left. Then continue typing. 

If your keyboard doesn't have a BACKSPACE or 
DEL key, you can accomplish the same thing by 
typing CTRL-H. To type CTRL-H, you hold down 
the CTRL key while typing the letter H. 

If you want to delete the entire line you've 
typed, you could keep typing BACKSPACE until 
it's all gone. An easier way is to type 
CTRL-X or CTRL-U (hold down CTRL while typing 
X or U) , which accomplishes the same thing. 

If you accidentally misspell the name of a 
command, and hit RETURN before realizing your 
mistake, TurboDOS will tell you that it can't 
find a command with that name: 



OA} DIT 
DIT B: 
OA} 



^1. 
< — Command not found 



and you can then retype the intended command. 
Likewise, if you enter a command TurboDOS 
can't figure out, it will let you know: 



QA} DIRB; 
DIRB: <- 
OA) 



Invalid command 
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Attention Requests You can suspend the execution of a program or 

command at any time by typing the "attention" 
character on your console keyboard. In most 
installations, this is either CTRL-S or 
CTRL-@. TurboDOSwill "beep" to acknowledge 
that it has received your attention request 
and suspended execution of your program. 

After an attention request, your program will 
remain suspended until you type one of the 
following attention responses: 

CTRL-'' (resume) simply restarts execution of 
your program at the point it was interrupted. 
You will find this attention/resume sequence 
useful to prevent displayed information from 
scrolling off the top of your console screen 
before you have time to read it. 

CTRL-C (abort) cancels program execution, and 
returns you to the TurboDOS command prompt. 

CTRL-P (echo-print) restarts program execu- 
tion and causes all subsequent console output 
also to be echoed on the printer. A second 
attention/echo sequence turns off echoing of 
console output to the printer. This feature 
is useful for getting hardcopy of your con- 
sole interactions with the system. 

CTRL-L (end-print) restarts program execution 
after signalling the end of the current print 
job. This is useful primarily when spooling, 
because it causes all accumulated print out- 
put to be immediately queued for printing. 
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Summary This section has covered some of the basics 

you need to know about TurboDOS. You've 
learned what an operating system is, how 
TurboDOS compares with other microcomputer 
operating systems, and what kind of hardware 
it runs on. You've also learned how to load 
TurboDOS from a cold start, log on, enter 
commands and command strings, correct typing 
errors, and make attention requests. 

Our next topic is one of the most important 
in this guide: files and disks. 
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FILES AND DISKS 



In this section, you will learn more about 
how TurboDOS does its most important job: 
managing your files and disks. 



What is a File? 



A "file" is a collection of related infor- 
mation stored on disk. Files may contain 
data (numbers, text, formulas, pictures, and 
so on) or computer programs. 

You can think of a file on disk as being like 
a file folder in a file cabinet. When you 
store information in a file cabinet, you use 
file folders to group related information 
together. For instance, one folder might 
contain information about company employees 
(names, addresses, telephone numbers, and so 
forth). You might label this folder "Em- 
ployee Data" so you can find it later. 

Using your computer's disk instead of a file 
cabinet, you could set up a disk file con- 
taining the employee information. You might 
give this file the name EMPLOYEE.DAT. To 
keep track of your files, you have to give 
each one a name. 
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Identifying Files 



TurboDOS keeps track of your files by name. 
It maintains a directory of the files on each 
disk. Whenever you want to access a particu- 
lar file, you simply identify the one you 
want by name. 



Names and Types 



Within limits, you can give your files any 
names you want. Each file name can be up to 
eight characters long. Try to make up names 
that will remind you what each file contains: 



EMPLOYEE 
CUSTOMER 
PAYROLL 



CONTRACT 

TAXINPO 

USRGUIDE 



LOANCALC 
STARTREK 
PAYCHECK 



As you create more and more files, you will 
find they begin to fall into natural catego- 
ries (commands, BASIC programs, documents, 
data base files, and so forth). To help you 
group similar files together, you may add an 
optional extension (called a "file type") to 
your file names. The file type can be up to 
three characters long, and is always sepa- 
rated from the file name with a period: 



EMPLOYEE.DAT 
CUSTOMER.DAT 
PAYROLL.DAT 



C0NTRACT.DOC 

TAXINF0.DOC 

USRGUIDE.DOC 



LOANCALC. BAS 
STARTREK. BAS 
PAYCHECK. BAS 



Certain file types have special meaning to 
TurboDOS. For example, Z80 commands (pro- 
grams) are kept in .COM files, and 8086 com- 
mands are kept in .CMD files. 

You can make up file names and file types 
using any desired combination of letters A-Z 
and digits 0-9. It's a good idea to stay 
away from punctuation marks. 
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Directories 



To keep track of your files, TurboDOS main- 
tains a file directory on each disk. For 
each file, the directory contains the name, 
type and attributes of the file, what user it 
belongs to, how big it is, and where it is 
located on the disk. 

You can use the DIR command to display or 
print the file directory on any of your 
disks. For example: 



OA}niE 

THISDISK.LAB 
22 FILES 



15-Apr-84 
OA:*.* 



C0NTRACT.DOC 12K 
CUSTOMER.DAT 5 8K 
EMPLOYEE.DAT 28K 
etc. 
OA) 



900K REMAINING 
324K DISPLAYED 

STARTREK.BAS 8K 
TAXINFO .DOC 2K 
USRGUIDE.DOC 96K 



The DIR command displays the files in alpha- 
betical order by name, and shows you the size 
of each one in kilobytes. (A kilobyte is 
1024 bytes.) It also shows you how much 
unused space remains on the disk, and other 
pertinent information. 
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Wild-Cards Sometimes it's convenient to be able to refer 

to an entire group of files, such as "all 
payroll data files" or "all BASIC program 
files". For this purpose, TurboDOS provides 
two special characters ? and * that can be 
used in file names and types. 

You can use the ? in a file name or type as a 
"wild-card" to match any character in the 
corresponding position. You can use the * to 
indicate that all remaining character posi- 
tions of the file name or type are wild- 
cards. 

For example, the command: 



OA} DIR PAY7FILE.DAT 



might list the following files: 



PAYOFILE.DAT PAYAFILE.DAT 
PAY5FILE.DAT PAYXFILE.DAT 
PAY9FILE.DAT PAYZFILE.DAT 



while the command: 



OA} DELETE *.BAS 



would delete all files of type .BAS from the 
disk. 

You'll find these wild-cards especially use- 
ful in connection with certain TurboDOS com- 
mands (such as COPY, DIR, DELETE, and RENAME) 
for processing a group of files without 
having to name each one individually. 
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Drive Selection Your computer system may be equipped with 

several disk drives (up to 16 of them). Each 
drive is assigned a letter A-P. In its com- 
mand prompt, TurboDOS reminds you which drive 
it is currently working on. 

When you refer to a file by name, TurboDOS 
normally looks for that file on the current 
drive. To access a file on a different 
drive, you have to enter a drive letter and a 
colon in front of the file name. 

For example, if you enter: 



I OA} DELETE B; DOCUMENT. TXT I 

I I 

TurboDOS will look for the file DOCUMENT.TXT 
on drive B, even though the current drive is 
drive A. 

You can also use a drive specification in 
front of a command keyword to indicate that 
you want TurboDOS to load the command from a 
particular drive: 



QA} C: DELETE B: STARTREK .BAS 



In this example, TurboDOS would look for 
DELETE.COM (or DELETE.CMD) on drive C, and 
for STARTREK.BAS on drive B. 
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Drive Selection If you need to access many commands or files 
(Continued) on the same drive, you might find it 

convenient to change the current drive so 
that you don't have to keep specifying the 
drive explicitly on every reference. To 
change the current drive, simply type the 
drive letter, a colon, and then RETURN: 



i OA}^ 
I OB) 
I 



Notice that TurboDOS changes its command 
prompt to indicate the new current drive. 

Working with Files At this point, let's see how you can accom- 
plish some basic file operations using Turbo- 
DOS. These include creating, copying, renam- 
ing and deleting files. 

Creating Files TurboDOS does not have any special command to 

create a file. Most of the time, you create 
new files by running application programs. 
For example, to create a text file you would 
probably use a text editor or word processing 
program. You can also create files by making 
copies of other files. 

When a program creates a new file, the file 
starts out empty. As the program writes 
information to the file, TurboDOS automatic- 
ally allocates additional disk space. A file 
can grow as large as needed, limited only by 
the size of the disk. When a file is dele- 
ted, the disk space previously occupied by 
the file becomes available again. 
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Copying Files 



To copy a file, use the COPY command: 



OAlCO PY OR IGI NAL. g A S PUP LIC A T. B AiS 

OA: ORIGINAL. BAS copied to OA:DUPLICAT.BAS 

OA} 



If the second (destination) file name is not 
given in the COPY command, then the first 
(source) name is used: 



0A} COPY ORIGINAL. BAS C: 

OA: ORIGINAL. BAS copied to OC: ORIGINAL. BAS 

OA} 



You can use wild-cards to copy a group of 
files with a single command: 



OA} CQPY *.BAS C; 

Confirm individual files (y/n) ? B. 

0A:LOANCALC.BAS copied to 0C:LOANCALC.BAS 

OA: ORIGINAL. BAS copied to OC: ORIGINAL. BAS 

OA:STARTREK.BAS copied to OC:STARTREK.BAS 

OA} 



The COPY command is one of the most useful in 
TurboDOS. It has numerous features and op- 
tions that you'll want to study carefully 
when they're described later in this guide. 
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Renaming Files 



To change the name of a file, use the RENAME 
command: 



QA} RENAME LOANCALC.BAS LC.BAS 
0A:LOANCALC.BAS renamed OA:LC .HAS 
OA} 



Using wild-cards, you can rename a group of 
files: 



OA} RENAME STARTREK.* TREK.* 

Confirm individual files (y/n) ? B. 

OA: STARTREK. BAS renamed OA:TREK .BAS 

OA: STARTREK. COM renamed OA:TREK .COM 

OA: STARTREK. DOC renamed OA:TREK .DOC 

OA:STARTREK.REL renamed OA:TREK .REL 

OA} 



Deleting Files 



To erase a file from disk completely, use the 
DELETE command: 



OA} DELETE ORIGINAL. BAS 
0A:ORIGINAL.BAS deleted 
OA} 



Like COPY and RENAME, the DELETE command can 
be used with wild-cards to delete a group of 
files with one command. You should be 
especially careful when using DELETE, for 
obvious reasons. 
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Backing Up It is s.^tJL.Q.m^lu. important for you to make 

backup copies of all your disks. Disks can 
be damaged and files can be erased as a 
result of human error or equipment failure. 
Such an event can be catastrophic if you have 
no backup copy of the lost disks or files. 
However, if you have been conscientious about 
making backup copies, you can recover your 
programs and data easily. 

Always make a working copy of any new soft- 
ware package you purchase, and save the ori- 
ginal. If the working copy is destroyed for 
any reason, you can always restore it from 
the original. 

Always make frequent backup copies of any 
programs and data files you are working on. 
As a general rule, you should make daily 
backup copies of all files you created or 
changed during the day. In many instances, 
it is prudent to make copies more frequently 
than once a day. 

There are two ways to make backup copies: 
using the COPYF command or the COPY command. 
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Using COPYF 



The COPYF command creates an exact duplicate 
of the contents of one floppy on another 
floppy of the same type: 



1 A) COPYF A: B: 








1 PROG ID: COPYF 


Revision 2 


.0 


1 IMS INTERNATIONAL 

1 Copy Floppy Disk Utility 






1 Sector Size: 1024 
1 Density: D 
1 Number of sides: 2 
i Number of cylinders: 


77 






1 Specified source drive: A 

1 Specified destination drive: B. 




1 Type <CR> to continue 
1 abort 
1 *? 

1 • 


or 


<CTRL-C> 


to 


1 Copying cylinder 76 








i — Copy complete — 









The COPYF command can be used only to copy 
an entire disk to another disk of exactly the 
same kind and format. COPYF is the fastest 
method of copying a disk, because it copies 
everything in one operation. See page x-x. 
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Using COPY 



The COPY cominand can also be used for making 
backup copies. You can use COPY to copy all 
files from one disk to another: 



OA} COPY A; B; ;N 

OA: ALPHA .COM copied to OB: ALPHA .COM 

OA:BETA .BAS copied to OB:BETA .BAS 



OA:ZULU 
OA} 



.DAT copied to OB: ZULU 



.DAT 



COPY is slower than COPYF because it copies 
one file at a time. COPY has some advan- 
tages, however. You can copy from one kind 
of disk to another -- from a hard disk to a 
floppy disk, for example. You can copy 
selected files or groups of files if you 
wish. In addition, the COPY command has an 
"archived" option for copying only those 
files that have been changed since last time 
you backed up. See page x-x. 
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Working with Disks So far, we've seen how TurboDOS works with 

files stored on disk. A single disk can hold 
dozens of files, sometimes hundreds of them. 
However, certain TurboDOS commands and faci- 
lities deal with the disk itself, rather than 
with the individual files stored on it. 



Kinds of Disks A disk is a rotating magnetic medium used by 

a computer system to store programs and data. 
Information is recorded on disk magnetically, 
much as voice or music is recorded on audio 
tape. The term "disk" applies to several 
kinds of storage media: floppy disks, remov- 
able cartridge disks, and fixed hard disks. 

Floppy disks (also called "diskettes") are 
inexpensive, and often the only kind of stor- 
age available on small microcomputer systems. 
They are removable disks which use a flexible 
magnetic medium that spins inside a cardboard 
jacket. Floppy disks come in 8-inch and 
5.25-inch diameter sizes (even smaller ones 
are being developed). They may be recorded 
on one or both sides, and commonly have capa- 
cities of 150K to 1,500K (kilobytes). 

Cartridge disks are also removable, but they 
use a rigid ("hard") medium that allows much 
more data to be stored on each disk. They 
are considerably more expensive than flop- 
pies, so their use on microcomputer systems 
has been somewhat limited. Cartridge disks 
come in 14-inch, 8-inch, and 5.25-inch diame- 
ters, and typically hold 2 to 20 megabytes (a 
megabyte is 1024K, more than a million 
bytes) . 



2-12 



TurboDOS 1.4 
User's Guide 



FILES AND DISKS 

Working with Disks 
(Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Kinds of Disks 
(Continued) 



Disk Formats 



Fixed hard disks (sometimes called "Winches- 
ter" disks) use one or several rigid magnetic 
platters sealed inside an airtight container. 
They provide a reliable and economical means 
of storing a lot of information (typically 5 
to 50 megabytes), and are rapidly becoming 
popular in medium-to-large microcomputer sys- 
tems. The disadvantage of such disks is that 
they are non-removable. Consequently, some 
other kind of removable medium (floppy disk, 
cartridge disk, or tape) is almost always 
required for backup and archive purposes. 



Information is recorded on disks along con- 
centric circular "tracks", somewhat like the 
grooves on a phonograph record. Each track 
is further subdivided into fixed-length "sec- 
tors". The "format" of a disk refers to how 
many tracks are recorded on the disk (on 
either one or both sides), how many sectors 
are recorded on each track, and how many 
bytes are recorded in each sector. 

For some kinds of disks ("hard-sectored"), 
the format is fixed by the hardware itself. 
For others ("soft-sectored"), the format must 
be pre-recorded onto the disk by means of the 
TurboDOS COPYF command before the disk can 
be used. Most floppy disks and many hard 
disks are soft-sectored. 

For maximum capacity and performance, floppy 
disks used with TurboDOS are generally for- 
matted with large sector sizes (typically 512 
or 1024 bytes). However, TurboDOS can also 
accomodate standard CP/M formats. TurboDOS 
determines automatically whether a floppy 
disk is recorded in CP/M or TurboDOS format. 
TurboDOS-f ormat diskettes hold 25% to 35% 
more data, and run very much faster. The 
COPYF command can initialize a disk in 
either CP/M or TurboDOS format. 
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Disk Formats 
(Continued) 



You must use COPYF to format every disk 
before it can be used by TurboDOS for the 
first time: 



1 OA) FORMAT 


B; 




1 


1 PROG ID: 


FMTF Revision 2. 







1 IMS INTERNATIONAL 






I Floppy Disk Format Utility 






1 Enter "T" 


or "C" for TurboDOS or CP/M 


sector 


size 


1 ?1 








1 Enter "S" 


or "D" for single-density or doubl 


e-density 


1 ?D 








1 Enter "1" 


or "2" for single-sided or 


double- 


sided 


1 ?2 








1 Selected . 


sector size type: T 






1 Selected ( 


density: D 






1 Selected ] 


number of sides: 2 






1 FMTF will 


format diskette in floppy drive A 




1 Type <CR> 
1 *? 


to continue or <CTRL-C> to 


abort 




1 Formatting Cylinder 76 






1 Verifying 


Cylinder 76 






1 — Format 


Complete — 
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It is also a good idea to use the ERASEDIR 
command to create an empty directory on the 
newly-formatted disk, and to use the LABEL 
command to give a name to the disk: 



Disk Organization 



OAl ERASEDIR B: 

Hashed directory desired (Y/N) ? R 

OK to erase directory on drive B? Y 

Erasing directory 

Directory erased, non-hashed 

A) LABEL B: PAYROLL.DAT 

Disk label written 

OA) 



You must use this procedure whenever a new 
disk is placed into service for the first 
time. You may also use this procedure when- 
ever you want to erase everything from a used 
disk and start out fresh. Be careful — once 
you use FMTF or ERASEDIR, any files pre- 
viously stored on the disk are lost forever. 
You don't really need to know how disks are 
organized in order to use TurboDOS, but it 
can be helpful in understanding certain disk- 
oriented commands. Each disk is organized by 
TurboDOS into five areas illustrated below: 



I File Storage 



File Storage 
Directory 



Allocation Map 
Volume Label 
Reserved Tracks 
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The "reserved tracks" are required by certain 
hardware configurations to support system 
start-up, but not otherwise used by TurboDOS. 
If your equipment requires reserved tracks, 
you can use the BOOT command to write infor- 
mation on them. 

The "volume label" contains the name you have 
assigned to the disk. The LABEL command lets 
you give a name to each of your disks. 

The "allocation map" is the area in which 
TurboDOS keeps track of which portions of the 
disk storage space are occupied with informa- 
tion, and which portions are free. You can 
use the FIXMAP command to reconstitute this 
critical information whenever you suspect it 
might have become corrupted. It is a good 
idea to use FIXMAP after any "crash" or other 
unexplained system malfunction. 



2-16 



TurboDOS 1.4 
User's Guide 



FILES AND DISKS 

Working with Disks 
(Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Disk Organization 
(Continued) 



The "directory" is a table of contents which 
lists all files stored on the disk. For each 
file, there is a directory entry containing 
the file's name, type, attributes, ownership, 
size, and location on the disk. The DIR 
command lets you display or print the direc- 
tory. The FIXDIR command lets you reorganize 
the directory when frequent additions and 
deletions of files cause directory access to 
become less efficient. 

All the rest of the disk (most of it) is 
available to hold your files. You can obtain 
details about the format and organization of 
any disk by using the DRIVE command: 



QA} DRIVE C: 

Disk drive characteristics, drive C 



Maximum data capacity 
Allocation block size 
Number of directory entries 
Physical sector size 
Physical sectors per track 
Physical tracks per disk 
Number of reserved tracks 
Media is removable 
OA) 



1224K 

2048 

256 

1024 

16 

77 





Unlike TurboDOS, CP/M does not maintain a 
volume label or allocation map on the disks 
it creates. When a CP/M disk is first ac- 
cessed by TurboDOS, the first few CP/M direc- 
tory entries are automatically relocated to 
the end of the directory in order to make 
room for the label and map. When a TurboDOS 
disk is accessed by CP/M, the label and map 
appear to be ordinary deleted directory en- 
tries. The result is that disks can be moved 
freely between CP/M and TurboDOS without 
concern about the differences in organiza- 
tion. 
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Directory Formats 



In addition to CP/M-compatible "linear" di- 
rectories, TurboDOS also supports an optional 
"hashed" directory format that makes look-up 
in large directories much faster. 

The standard linear directory format is 
media-compatible with CP/M, and is searched 
sequentially. Because of this, look-up speed 
gets slower as the directory gets bigger. 
For hard disks with big directories, look-up 
time can get painfully slow. 

The optional hashed directory format uses a 
"hashing algorithm", a sophisticated tech- 
nique for making look-up on large directories 
much faster. A hashed directory may be used 
on any disk, but is especially suited for use 
on hard disks with big directories. Hashed 
directories are not media-compatible with 
CP/M (but CP/M applications still run fine). 

To initialize a disk to use this optional 
hashed directory format, use the ERASEDIR 
command. Alternatively, to change an exist- 
ing directory from linear to hashed (or vice- 
versa), use the FIXDIR command: 



OAlFIXD IR C; 

Hashed directory desired (Y/N) ? Y 

OK to reorganize directory on drive C? Y 

Reorganizing directory-DO NOT INTERRUPT 

Directory reorganized, hashed 

OA} 



When you display a hashed directory using 
DIR, the symbol "(H)" appears in the heading. 

Whether the directory is linear or hashed, 
searches involving "wild cards" have to be 
done linearly. Such wild-card searches are 
typically slower if the directory is hashed. 
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Changing Disks 



Multi-user systems require special care when 
changing floppy disks (or other removable 
media). First, you should check to make sure 
that no other user is using the disk you want 
to change. Then use the CHANGE command to 
let TurboDOS know you want to change disks: 



OA) CHANGE 

Enter drive (s) to be changed: BCD 

Change drive (s) BCD 

Enter <CR> when change complete 



Wait until the CHANGE command tells you it's 
okay to change the disks (as above). Then 
remove and replace disks as required. Final- 
ly, press RETURN to advise you are done with 
the change. Remember, never remove a disk 
without first entering a CHANGE command. 

In a single-user system, it is safe to change 
disks whenever the system pauses for console 
input. You don't have to use CHANGE. 



Disk Errors 



If you hear a "beep" and see a diagnostic 
message on your console such as: 



Read Error, Drive A, Track 0, Sector 2 
[Retry, Ignore, Abort] 

Write Error, Drive B, Track 5, Sector 16 
[Retry, Ignore, Abort] 



it means that TurboDOS could not read or 
write the specified disk sector even after a 
number of retries. When you see such a mes- 
sage, you must choose one of three recovery 
options (Retry, Ignore, Abort) by keying the 
letter R, I, or A. 
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Disk Errors If you key R (retry), TurboDOS will try the 
(Continued) read or write operation several more times. 

If it is still unsuccessful, you will get 

another message. 

If you key I (ignore), processing will con- 
tinue as if the error had not occurred. This 
option is not recommended in most situations 
because it causes processing of invalid data 
and may lead to other errors. 

If you key A (abort), TurboDOS terminates the 
program you were running when the error oc- 
curred. 

If you hear a "beep" and see this message on 
your console: 



I I 

I Not Ready Error, Drive C [Retry, Abort] I 

I I 

it means TurboDOS could not access the selec- 
ted drive for one of the following reasons: 

. there's no such drive on your system 
. the drive isn't ready to operate 
. the drive's door was left open 
. no disk is mounted in the drive 
. the disk hasn't been formatted 
. the disk format is unrecognizable 
. in the case of certain commands (COPYF, 
BOOT, FMTF and VERIFY), the drive is 
not local to the processor in which you 
are executing the command 

Again, you must select the desired recovery 
option by keying R or A. 
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User Numbers You know already that TurboDOS maintains a 

directory on each disk which lists all files 
on the disk. Within the directory, TurboDOS 
provides up to 32 separate file libraries 
corresponding to user numbers 0-31. These 
libraries are especially useful in a multi- 
user system, since they allow you to maintain 
separation between files belonging to dif- 
ferent users or applications. 

When you first log on to a multi-user Turbo- 
DOS system, the system assigns you to one of 
these user numbers according to the user id 
that you specify. You can see which user 
number you have been assigned by looking at 
the command prompt. For example: 



5B} 



tells you that your user number is five. 
Generally, user is reserved for global 
files (explained shortly) and user 31 is 
reserved for log-on security, leaving 1-30 
for general use. 

Ordinarily, you are confined to your assigned 
user number from log on until log off. Most 
file operations (creating, renaming, delet- 
ing, searching, etc.) are confined to the 
library which corresponds to your user num- 
ber. For example, if you enter the command: 



I I 

you will get a directory of only those files 
in the user 5 library on drive B. 
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User Numbers 
(Continued) 



The log-on mechanism of TurboDOS permits 
certain user id's to be "privileged", allow- 
ing those users to access various protected 
facilities of TurboDOS. A privileged user 
may access any user number. User numbers are 
selected just like drive letters. To change 
the current user number, for example: 



5B}i2_L 
20A} 



To display the directory for a particular 
user number and drive: 

I I 

I OA} DI R 1 2P; I 



Or to copy files from one user number and 
drive to another: 



OAI CQ PY 123;*. B A S 20A; 



Remember, ordinary (non-privileged) users are 
not allowed to access other user numbers: 



5B}12i 

12: < — Non-privileged user 

SBl DIR 12: 

Non-privileged user 

5B} 



In most single-user TurboDOS systems, log on 
is not required. You are logged on automa- 
tically to user zero and privileged. From 
there, you can access any user number. 
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File Attributes 



Read-only File 



Global File 



File attributes may be used to control how a 
file can be accessed. TurboDOS defines four 
such attributes: Read-only, Global, Archived, 
and FIFO. Each of these attributes is ex- 
plained in detail below. 



You can set and 
the SET command. 



clear file attributes with 
For example: 



QA} SET *.COM ;N +RG -A 
0A:COPY .COM set to RG 
OA: DELETE .COIA set to RG 
OA: RENAME .COM set to RG 

OA} 



sets all .COM files to Read-only, Global, and 
not Archived. The SHOW command lets you see 
the settings of file attributes. 



TurboDOS lets you protect important files and 
disks against accidental destruction by mark- 
ing them with the "read-only" attribute. 
Read-only files can't be written, deleted or 
renamed. (To delete, rename or modify a 
read-only file intentionally, you must first 
clear the read-only attribute.) 



If you save a file under user and mark it 
with the "global" attribute, you can access 
that file from any user number. This pro- 
vides a convenient way to make selected files 
available to all users. For example, you'd 
probably want to do this with most TurboDOS 
commands and other common programs. (Other- 
wise, you'd have to put duplicate copies 
under each user number, wasting disk space.) 
Remember, global files must be in the user 
library -- otherwise, the global attribute 
has no effect. 
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Archived File 



The "archived" attribute works together with 
the COPY command to provide a convenient 
mechanism for doing incremental file backup. 
This attribute is set automatically whenever 
a file is archived by the COPY command, and 
cleared automatically whenever a file is 
written or renamed. When the COPY command is 
used for archiving, it automatically skips 
over files which have the archived attribute 
set. As a result, only files that have been 
written or renamed since the last archiving 
cycle are copied. 

This incremental backup facility is particu- 
larly useful for backing up fixed disks, 
where copying all files would be too slow. 



FIFO File 



The "FIFO" attribute causes a file to be 
accessed by TurboDOS using a special first- 
in-first-out access method. FIFO files are 
especially convenient for inter-process and 
inter-user communications, and are described 
in more detail in the Programmer's Guide . 



Read-only Drive 



TurboDOS allows drives to be marked read-only 
much in the same fashion as files. Another 
variation of the SET command is used: 



QA} SET C: ; +R 
Drive C set to 
OAl SET C; ;-R 



Drive 
OA} 



C set to 



read-only 
read/write 



Setting a drive read-only prevents TurboDOS 
from making any attempt to write to that 
drive. This is a good way to protect impor- 
tant disks against accidental destruction 
while making backup copies, for instance. 
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File Searches Whenever you ask to access a file, TurboDOS 

first searches the library corresponding to 
the current (or specified) user number. If 
the file is not found, TurboDOS then searches 
the user library to see if the file is 
there and is marked as global. For example, 
if you entered this command: 



5B} TYPE C:TAXINFQ.DQC 



TurboDOS would first search the user 5 libra- 
ry on drive C. If it can't find TAXINF0.DOC 
there, then it searches the user directory 
on drive C, looking for TAXINF0.DOC marked 
with the global attribute. If both searches 
are unsuccessful, the TYPE command displays 
the message "File Not Found". 

The search procedure for command files (pro- 
grams) is similar, but with one added compli- 
cation. TurboDOS can be configured with a 
specified "search drive" which is searched 
automatically if you don't specify an expli- 
cit drive letter, and if the normal search of 
the current drive fails. Using the previous 
example, if your system is configured with 
drive A as the "search drive", TurboDOS would 
search for the command file TYPE.COM (or 
TYPE.CMD) in the following sequence: 



drive B, user 5 

drive B, user (global) 

drive A, user 5 

drive A, user (global) 



before giving up and displaying the message 
"Command Not Found". 
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File Sharing In a multi-user TurboDOS system, it is quite 

possible that two or more users may want to 
access the same file at the same time. This 
can happen if the users are logged on to the 
same user number, or if they are accessing 
the same global file. TurboDOS has various 
facilities to regulate such file sharing. 

File Locks As a general rule, TurboDOS allows any number 

of users to read a file at the same time, but 
only one user may write the file. (This is 
called the "permissive" rule.) If a second 
user tries to write the file before the first 
user is finished, the second user will re- 
ceive an error message. The exact message 
depends upon the application programs being 
run, but is usually something like "cannot 
write file" or "disk full". 

Alternatively, it is possible to set up Tur- 
boDOS so that only one user can access any 
file at a time. (This is called the "exclu- 
sive" rule.) If your system is set up in 
this fashion, and if a second user tries to 
access the file before the first is finished, 
the second user will receive an error mes- 
sage, usually something like "cannot open 
file" or "file not found". 



Record Locks TurboDOS also has record locking facilities 

that make it possible for several users to 
access and update common files at the same 
time. Record locking is not automatic. Pro- 
grams must make explicit requests for Turbo- 
DOS to open files in a special "shared" mode, 
and to lock and unlock records. 

Remember, simultaneous updating requires ap- 
plication programs specially-written for a 
multi-user environment. Ordinary single-user 
applications will not do. 
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Summary This section has explained how TurboDOS mana- 

ges your files on disk. You've learned what 
files are, how they are identified by name, 
and how you can create, copy, rename and 
delete them. You know how TurboDOS disks are 
organized, and the proper procedures for 
formatting disks, changing disks, and recov- 
ering from disk errors. You understand the 
importance of making frequent backup copies 
of your important programs and data files. 
And you know about user numbers, file attri- 
butes, and file sharing. Congratulations! 

Next, we look at how TurboDOS handles print- 
ing and print spooling. 
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Inc. 



PRINTING 



Printing Methods 



This section teaches you all about printing 
under TurboDOS, including how to use its 
print spooling capabilities to best advan- 
tage. The printing facilies of TurboDOS are 
rather elaborate, so there's quite a bit to 
learn. 



We'll start by describing the various print- 
ing methods supported by TurboDOS. Later, 
we'll go into detail about the commands used 
to control printing. 

Your^ system may be equipped with several 
printers (up to 16 of them), all of which may 
be in-use simultaneously. Each printer is 
assigned a letter A-P (just as in the case of 
disk drives). You can control which printer 
you want to use at any given time. In a 
multi-user system, each user can control his 
print routing independently. 

There are two fundamentally different methods 
of printing in TurboDOS: di rect and s pooled. 



Direct Printing 



Print output may be routed directly to any 
specified printer on a character-by-character 
basis. This is the simplest method of print- 
ing in TurboDOS, and the only method suppor- 
ted by CP/M. Direct printing is useful for 
very long print jobs (e.g., overnight), and 
for certain special situations such as 
single-sheet printing. 

Direct printing has some drawbacks, however. 
For one thing, when you use direct printing, 
your console is tied up until the print job 
has finished. Printers are generally the 
slowest components of any computer system, 
and you will find they are often a bottleneck 
limiting how much work you can get done. 
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Direct Printing Another drawback of direct printing is that 
(Continued) it is very awkward to use in a multi-user 

environment. If two users attempt to print 
directly to the same printer at the same 
time, the result is a merged printout that is 
not likely to be of much use to either user. 
Thus, direct printing requires that users 
carefully coordinate among themselves to 
avoid such conflicts. 

You can eliminate both of these problems by 
using spooled printing. 



Spooled Printing When you select spooled printing, TurboDOS 

intercepts the print output from your program 
and saves it in a print file on disk. This 
process is called "spooling", and the result- 
ing print file is sometimes called a "spool 
file". 

When the print job is done, TurboDOS automa- 
tically starts printing the contents of the 
print file. This process is called "de- 
spooling", and takes place in the background 
independent of your console. You can go 
ahead and run your next program without wait- 
ing for the printing to finish. When the 
printing is finished, the print file is dele- 
ted automatically. 

In a multi-user environment, several users 
may be generating spooled print output at the 
same time without any interference. As their 
jobs finish, TurboDOS automatically queues 
the print files for de-spooling on a first- 
come first-served basis. 
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Print Jobs When a program generates its first character 

of print output, a new "print job" begins. 
If spooled printing is in effect, TurboDOS 
creates a new print file automatically at 
this point. Subsequent print output is 
spooled to this print file until the print 
job ends, whereupon TurboDOS closes the print 
file and queues it for de-spooling. 

In most cases, the print job ends automa- 
tically at the conclusion of the program. 
However, the print job may also be ended by 
an end-print attention request from the con- 
sole, by an explicit end-print request from 
the program, or by the presence of a reserved 
end-of-print character in the print output 
stream (if one is defined for your system). 



Using Print Queues TurboDOS supports up to 16 print queues, 

identified by the letters A-P. A print queue 
is simply a list of print jobs awaiting de- 
spooled printing. You can assign any printer 
on your system to de-spool from any print 
queue. Jobs are always printed from a parti- 
cular queue on a first-come first-served 
basis. 

The simplest way to use these queues is to 
assign each printer to a different queue -- 
for example, printer A to queue A, printer B 
to queue B, and so on. However, queues may 
be used in more imaginative ways. 
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Using Print Queues Even if your computer has only one printer, 
(Continued) you may want to make use of several print 

queues to group together print jobs with 
similar forms requirements and/or priorities. 
For example, you could use queue A for jobs 
requiring wide paper, queue B for jobs to be 
printed on narrow paper, queue C for jobs to 
be printed on pre-printed invoice forms, 
queue D for computer-printed checks, and so 
forth. Whenever the printer is done printing 
all jobs from one queue, you can re-assign 
the printer to a different queue after chang- 
ing to the appropriate kind of paper. 

If your system has multiple printers, you can 
assign two or more printers to the same print 
queue. In this case, TurboDOS performs auto- 
matic load sharing by dividing up the work- 
load among the printers. This technique is 
appropriate if you don't care which printer 
is used to print which job. 



Manual Spooling 



In addition to the automatic print spooling 
already described, TurboDOS supports a manual 
spooling mode in which print output is 
spooled to a print file but not automatically 
queued for printing when the print job ends. 
When you use this mode, the print file re- 
mains on disk indefinitely, until you either 
delete it or manually queue it for printing. 
TurboDOS provides a special command for manu- 
ally queuing such files (or any text file, 
for that matter). 

The manual spooling mode is useful in various 
situations: for example, when you're not sure 
whether or not you want to print a job; when 
you need to print several copies of the same 
job; or when you want to use the print output 
of one program as the input to some other 
program. 
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De-Spooling De-spooling is an automatic background acti- 
vity which generally requires no operator 
attention. However, TurboDOS lets you exer- 
cise control over de-spooling in various ways 
when necessary. 

You can assign any printer to de-spool from 
any print queue, or place any printer in an 
"off-line" status (to allow you to change 
paper or ribbons, for example). You can stop 
and restart printing on any printer, restart 
any print job from the beginning, or termi- 
nate any print job altogether. These control 
functions may be exercised from any user 
console. 

Now that we've reviewed the printing capabi- 
lities of TurboDOS, let's look at the com- 
mands for controlling print routing, queuing, 
and de-spooling. They are PRINT, QUEUE, and 
PRINTER. 
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Routing Control 



The PRINT command controls the routing of 
print output. In a multi-user system, each 
user may control his own print routing inde- 
pendently. 



Direct Printing 



Automatic Spooling 



To select the direct printing mode, you need 
only specify which printer (A-P) you wish to 
use: 



OAIPRX NT P R INTE R= B 
Printing is to PRINTER B 
OA) 



When using direct printing in a multi-user 
system, make sure no one else uses that 
printer until your printing is finished. 



To select the automatic spooling mode, you 
must specify on which queue (A-P) you want 
your print job placed. You may also specify 
the disk drive onto which you want the print 
file to be written: 



OAi PRINT DRIVE=C OUEUE=A 
Printing is to SPOOLER on DRIVE C 

to QUEUE A 
OA} PRINT OUEUE=B 
Printing is to SPOOLER on DRIVE C 

to QUEUE B 
OA} 



If you don't specify the spool drive, it will 
remain the same as before. 
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Manual Spooling 



Other Options 



To select the manual spooling mode (in which 
the print file is not automatically queued), 
the keyword FILE is used: 



OA} PRINT FILE 

Printing is to SPOOLER on DRIVE C 

A) PRINT FILE DRIVE=A 

Printing is to SPOOLER on DRIVE A 

OA} 



Again, you need to specify the spool drive 
only if you want to change it. 



You can direct print output to your console 
with the following command: 



OA} PRINT CONSOLE 
Printing is to CONSOLE 
OA} 



You can cause print output to be discarded 
altogether by using this command: 



OA} PRI NT QF FLX NE 
Printing is to OFFLINE 
OA} 



Finally, a PRINT command with no parameters 
displays your current print routing: 



0A} P R I NT 

Printing is to SPOOLER on DRIVE A 

to QUEUE A 
OA) 
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Queuing Manually 



The QUEUE command lets you manually queue 
print files (or any text file) for de-spooled 
printing: 



OA) QUEUE TEXTFILE.PRN 
OA:TEXTFILE.PRN queued 
OA) 



The QUEUE command lets you specify which 
queue you want to use, but if you don't (as 
in the example above) the current queue is 
used (as set by the last PRINT command). You 
can specify that you want the file to be 
deleted after it is printed. You can even 
use wild-cards in the file name to queue a 
group of files with a single command. For 
details on all these variations, refer to the 
QUEUE command description later in this docu- 
ment. 
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De-Spool Control 



The PRINTER command lets you control de- 
spooled printing on any printer in your sys- 
tem. This command may be used by any user 
from any console. 



Queue Assignment 



To assign a printer (A-P) to de-spool from a 
particular print queue (A-P): 



OA) PRINTER A C)UgUE= C 

PRINTER A assigned to QUEUE C 

OA) 



If the printer is currently printing, the new 
assignment takes effect at the end of the 
current print job. 

To display the current de-spool assignment of 
a particular printer: 



OA) PRI NTER A 

PRINTER A assigned to QUEUE C 

OA} 



To take a specified printer off-line at the 
end of the current print job: 



OA} PRINTER A OFFLINE 

PRINTER A assigned to OFFLINE 

OA} 



The purpose of taking a printer off-line is 
to prevent subsequent de-spooling to that 
printer. This is useful when you want to 
change paper ot ribbons, or when you want to 
reserve the printer for direct printing. 
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Print Job Control 



To temporarily suspend de-spooling to a spe- 
cified printer (to correct a paper jam, for 
example) : 



0A> PRINTER A STOP 

PRINTER A assigned to QUEUE C (Stopped) 

OA} 



To resume de-spooling from the point it was 
stopped: 



OA) P RINT E R A GQ 

PRINTER A assigned to QUEUE C 

OA} 



To Stop de-spooling to a specified printer 
and restart the current print job from the 
beginning when de-spooling is resumed: 



OA) PRI NT ER A P EG IN 

PRINTER A assigned to QUEUE C (Stopped) 

OA) 



To terminate the current print job on a spe^ 
cified printer, and continue with the next 
queued job: 



QA} PRINTER A TERMINATE 
PRINTER A assigned to QUEUE C 
OA} 



The terminated print file is not deleted from 
disk, so the job may be manually re-queued 
with the QUEUE command. 
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Spooler Errors If you hear a "beep" and see the following 

diagnostic message on your console: 



Spooler Error (Ignore, Abort) 



it means that the disk to which you were 
spooling has run out of space in the middle 
of your print job. TurboDOS has closed your 
print file (prematurely), but has not queued 
it for de-spooling. 

When you see this message, you must choose 
one of the two recovery options (Ignore or 
Abort) by keying the letter I or A. 

If you key I (ignore), your print routing is 
set to "off-line", and your program will 
continue with any further print output dis- 
carded. 

If you key A (abort), your program will be 
terminated. 



Summary In this section, you've learned all about 

printing and print spooling in all its many 
variations. 

Next, you will find out more about how Turbo- 
DOS processes commands. 
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PROCESSING This section teaches you about the various 

processing methods available under TurboDOS, 
including interactive and batch processing in 
both single and multi-processor environments. 



Command Processing A TurboDOS command always identifies a pro- 
gram file residing on disk, and causes that 
program to be loaded into memory and execu- 
ted. TurboDOS has no "built-in" commands. 

TurboDOS comes with more than 30 standard 
command programs (described in detail in the 
next section). You can expand the vocabulary 
of commands by adding programs you purchase 
or programs you write yourself. Program. 
files are distinguished by their special 
type: .COM for Z80 programs, .CMD for 8086 
programs. 



Simple Commands Every TurboDOS command consists of the file 

name of the program to be executed, possibly 
followed by an optional "command tail". 

The program name may have an explicit file 
type, but usually doesn't (TurboDOS assumes 
.COM or .CMD as appropriate). It may also 
have an explicit drive specification (like 
"B:") if the program is not on the current 
drive. 

The format of the command tail is determined 
by the particular command (program) involved. 
TurboDOS simply passes the command tail (if 
any) to the program. The command tail cannot 
exceed 126 characters in length. 
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Command Strings 



TurboDOS also accepts strings of commands 
separated by the character \ (backslant). 
The length of a command string is limited 
only by the size of the TurboDOS command 
buffer (normally enough for a command string 
two lines long). 

TurboDOS executes each command of the command 
string in sequence: 



OAIDIR B:\DIR C:\DTR D; 

...(drive B directory)... 

OAlDIR C: 

. . . (drive C directory) . . . 

OA}DIR D: 

...(drive D directory)... 

OA} 



and re-displays each command but the first as 
it is executed (illustrated above). This 
command re-display is supressed if the com- 
mand string begins with a backslant: 



OA} \DI R g;\DIR C:\DJ:R D; 
...(drive B directory)... 
. . . (drive C directory) . . . 
...(drive D directory)... 
OA} 
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Batch Processing 



Simple Do-Files 



Sometimes you will find yourself performing 
certain command sequences quite frequently. 
It's convenient to save such sequences on 
disk, especially if they're long or complex. 
You can perform such pre-defined command 
sequences automatically with the DO command. 



Do-files are text files (usually type .DO). 
You can prepare do-files with your favorite 
text editing or word processing program. For 
example: 



OA} TYPE RUNPROG.DQ 

BASCOM PROG. REL, PROG. PRN=PROG.BAS/S/C 

TYPE PROG.PRN ;L 

DELETE PROG.PRN 

L80 PROG. REL/M/E, PROG. COM/N 

DELETE PROG. REL 

PROG 

OA) 



To execute the do-file, use the DO command; 



OA} DQ RUNP RQG 

0A}BASCOM PROG. REL, PROG. PRN=PROG.BAS/S/C 

. . . (compilation) . . . 
OA}TYPE PROG.PRN ;L 
...(listing to printer)... 
OA}DELETE PROG.PRN 

0A:PROG .PRN deleted 
0A}L80 PROG. REL/M/E, PROG. COM/N 
. . . (link map) . . . 
0A}DELETE PROG. REL 

OA: PROG .REL deleted 
A} PROG 

(execution of PROG program) — 

OA} 
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Simple Do-Files 
(Continued) 



Certain commands (such as COPY, RENAME and 
DELETE) may expect interactive input from the 
console keyboard. If such a command is exe- 
cuted from within a do-file, then its console 
input comes from the do-file rather than the 
keyboard. For example: 



OA} TYPg PEL P R QG.DQ 

DELETE 

PROG . PRN 

PROG.REL 

PR0G.COM 

0A} DO DELPROG 

OA}DELETE 

* PROG. PRN 

OA: PROG. PRN deleted 

* PROG.REL 

OA: PROG.REL deleted 

* PR0G.COM 

OA: PROG. COM deleted 
* 

OA} 



Most programs which expect keyboard input may 
be run from within a do-file in this fashion. 
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Do-File Parameters 



You can prepare a do-file with variable para- 
meters which can have different values each 
time you execute it. When you prepare the 
do-file, mark the position of parameters in 
the do-file as (1), {2}, and so on: 



OAl TYPE RUNMS.D Q 

BASCOM { 1 } . REL , ( 1 } . PRN= { 1 } . BAS/ S/C 

TYPE (D.PRN ;L 

DELETE {D.PRN 

L80 {1}.REL{2}/E,{1} .COM/N 

DELETE {D.REL 

{1} 

OA} 



When you execute the do file, specify the 
argument values in the command tail of the DO 
command. The first argument replaces each 
occurrence of (l) in the do-file, the second 
argument replaces each {2}, and so forth: 



0A} DO RUNBAS PROG /M 

OA} BASCOM PROG. REL, PROG. PRN=PROG. BAS/ S/C 

. . . (compilation) . . . 

OAlTYPE PROG.PRN ;L 

...(listing to printer)... 

OA} DELETE PROG.PRN 

OArPROG .PRN deleted 
0A}L80 PROG. REL/M/E, PROG. COM/N 
. . . (link map) . . . 
OA}DELETE PROG. REL 

OArPROG .REL deleted 
0A}PROG 

. . . (execution of PROG program) . . . 
OA} DELETE RUNBAS. D0$ 

OA: RUNBAS .D0$ deleted 
OA} 



4-5 



TurboDOS 1.4 
User's Guide 



PROCESSING 

Batch Processing 
(Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Do-File Parameters 
(Continued) 



Nested Do-Files 



When arguments are present, the DO command 
makes a temporary copy of your do-file in 
which arguments are substituted for parame- 
ters as required. The temporary file is 
executed, and then deleted when execution is 
done. 

Note: if the do-file contains parameter marks 
(such as {1}), then the DO command mnsi have 
at least one argument to activate the substi- 
tution process. A null argument such as "" 
or ' ' will suffice. 



Do-files may contain embedded DO commands 



OAl TYPE RUN. DO 

DO COMPILE {1} 

DO LINK {1} {2} 

{1} 

A} TYPE COMPILE. DO 

BASCOM { 1 } . REL , { 1 } . PRN= { 1 } . BAS/ S/C 

TYPE {D.PRN ;L 

DELETE (D.PRN 

OA} TYPE LINK. DO 

L 8 { 1 } . REL { 2 } / E , { 1 } . COM/ N 

DELETE {D.REL 

OA} 



Do-filesmay be nested in this fashion to any 
reasonable depth. 

If the last command in a do-file is a DO 
command which reinvokes the same do-file, 
then TurboDOS will repeatedly execute the do- 
file over and over again. In this case, it 
is important to omit the final RETURN and 
LINEFEED from the do-file; otherwise, Turbo- 
DOS will treat the DO command as recursive, 
and will eventually terminate execution when 
nesting becomes too deep. 
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Automatic Loading 



Program Autoload 



TurboDOS provides a simple means for automa- 
tically loading any program or executing any 
sequence of commands at initial start-up 
(cold start), or whenever a program termi- 
nates (warm start). You could use this fea- 
ture to cause automatic execution of an ap- 
plication function menu program or the LOGON 
command, for example. 

Autoload at cold-start takes place only if a 
file named COLDSTRT.AUT is present on the 
start-up disk. Autoload at warm-start takes 
place only if a file named WARMSTRT.AUT is 
present on the current disk. 



To cause a program or command to be loaded 
automatically, simply make a copy of the .COM 
or .CMD file under the name COLDSTRT.AUT or 
WARMSTRT.AUT as appropriate. For instance, 
for automatic LOGON operation, copy L0G0N.COM 
(or .CMD) to WARMSTRT.AUT under user 31. 



Command Autoload 



To cause a command or string of commands to 
be executed automatically, use the AUTOLOAD 
command to capture the desired command string 
in a file called AUTOLOAD. AUT. Then rename 
this file to COLDSTRT.AUT or WARMSTRT.AUT as 
appropriate. For example, to automatically 
set the system date and then execute a BASIC 
program called MENU at each cold-start: 



A} AUTOLOAD DATE SET I BASIC MENU 

Autoload file created. 

QA} RENAME AUTOLOAD. AUT COLDSTRT.AUT 

OA: AUTOLOAD. AUT renamed OA: COLDSTRT.AUT 
OA} 



Note that a newly-created .AUT file does not 
take effect until the next cold-start. 
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Networking 



As you know already, a multi-user TurboDOS 
system is actually a network of interconnec- 
ted microcomputers working together. A sepa- 
rate microcomputer supports each user's video 
console, and one or more additional microcom- 
puters may be used to manage disks, printers, 
communications channels, and other shared 
devices of the system. 

In general, you do not need to be concerned 
about the networking aspects of TurboDOS. 
When you read from drive C or print to prin- 
ter B, for example, you do not need to think 
about whether that disk drive is connected to 
your processor or to another processor in the 
network. TurboDOS automatically routes your 
requests to the proper destination without 
any explicit action on your part. 

However, there are a few cases in which you 
need to be conscious of the true multi-pro- 
cessor nature of the system. 



Local Commands 



A few TurboDOS commands require direct access 
to disk drive and controller hardware, and 
consequently may be executed only in the 
processor to which the disk is attached. 
These commands are: 



COPYF - Copy entire disk track-by-track 
BOOT - Read/write reserved tracks 
FMTF - Erase and initialize entire disk 
VERIFY - Scan entire disk for bad spots 



If you try to execute any of these commands 
in another processor, you will get the error 
message "Not ready error. Drive X". 
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Remote Console 



In many TurboDOS systems, disks and other 
shared peripherals are attached to a "master" 
or "server" processor which is separate from 
the processors to which user consoles are 
attached. If you need to run a program in 
the master processor (e.g., FMTF), you 
would ordinarily have to hook up a console 
device to the master. However, TurboDOS has 
a special command which lets you temporarily 
assign your console to the master without 
making hardware changes (a special console 
driver must be installed in the master): 



5C} MASTER 

Console attached to master processor 

OA} FMTF B: 



OA) <Attention/AbQrt> 

Console detached from master processor 

5C} 



The MASTER command attaches your console to 
the master processor. To detach, key in the 
Attention/Abort sequence. 



Memory Management 



Microcomputers use random-access memory (RAM) 
to hold both programs and data. TurboDOS 
itself occupies a certain amount of memory, 
and it needs additional memory for disk buf- 
fers, print queues, file interlocks, and 
various other things. All the memory space 
that is left over is called the "Transient 
Program Area" (TPA) , and is available for use 
by commands and application programs. 

Because memory is often a critical resource, 
it is important for you to understand how it 
is managed by TurboDOS. This varies depend- 
ing upon the hardware involved. 
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Non-Banked Z80 



A non-banked Z80 configuration is limited by 
hardware constraints to a maximum of 64K of 
memory. TurboDOS resides in the topmost 
portion of memory, and allocates its disk 
buffers and other dynamic space requirements 
immediately below itself. The TPA occupies 
the lower portion of memory; 



TurboDOS 



Disk Buffers 



Dynamic Space 



Transient 
Program Area 



12K-24K 



2K-8K 



IK 



32K-50K 



If you need additional TPA for a particular 
program, you can reduce the size of the disk 
buffer pool by using the BUFFERS command. 
However, you must make sure the system is 
quiescent (no programs running, no files 
open, no print jobs queued, etc.) so that 
there is no dynamic space allocated below the 
disk buffers. Then you can reduce the disk 
buffers and increase your TPA accordingly. 
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Banked Z80 



A banked ZBO configuration permits more than 
64K of memory by providing two memory banks 
(called "bank 0" and "bank 1"), only one of 
which may be active at a time. TurboDOS 
resides in bank along with its disk buffers 
and other dynamic space, while the TPA occu- 
pies bank 1. 

In order to allow the necessary inter-bank 
communications to take place, an area of 
common (non-switched) memory must be provided 
at the top of memory. Ideally, this common 
area should be IK, permitting each memory 
bank to be 63K. However, hardware design 
often dictates that the common area be larger 
than this, often as big as 16K. A large 
common area reduces the memory available for 
TurboDOS, but does not reduce the TPA size: 



TurboDOS Bank Mg r 



Transient Program 
Area (Continued) 



IK 



63K 

Total 

TPA 



TurboDOS 



Disk Buffers 



Dynamic Space 



: (Unused) : 

I I 

(Bank 0) 



Transient 
Program 
Area 



(Bank 1) 
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Banked Z80 
(Continued) 



80 86-Family 



Certain TurboDOS commands (COPYF, BOOT, 
FMTF, and VERIFY) will not run in a banked 
TPA. So that you can use these commands, 
TurboDOS provides a BANK command which lets 
you change between the banked and non-banked 
configurations at will. 



In an 80 86-f ami ly 
occupies lower memory. 



processor, TurboDOS 
with the TPA above: 



Transient 
Program 
Area 



Disk Buffers and 
Dynamic ^jLgje_ 



TurboDOS 



Since 8086-family processors can address up 
to a megabyte of memory directly, memory 
management is generally not a problem, and 
bank-switching is unnecessary. 



Summary 



In this section, you've learned how TurboDOS 
commands work, and various ways commands may 
be executed (command strings, do-files, auto- 
load). You also understand the effects of 
networking and memory management on your 
processing. 

Now we are ready to examine each TurboDOS 
command in detail. 
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COMMANDS This section describes each TurboDOS command 

in detail. For ease of reference, the com- 
mands are presented in alphabetical order. 



Presentation This section uses the following notation: 

Keywords are shown in capital letters, 
and must be entered as shown. (You can 
use either upper- or lower-case.) 

Parameters are shown in lower-case, and 
are described in the following text. 

Items shown in braces { } are optional. 
If you want to include such an optional 
item, do not type the braces, but only 
the information inside. 

An ellipsis ... indicates that the pre- 
ceding item may be repeated as many 
times as you like. 

Spaces and punctuation characters must 
be entered as shown (except for braces 
{ } and el ipses ...) . 

Command options are usually introduced 
by semicolon; several options may be 
combined following a single semicolon. 

The command name and any file name arguments 
in the command tail may be prefixed by a 
drive letter, a user number, or both. Any of 
the following prefix formats are accepted: 



I I 

I drfile uudrfile uu:d:file I 
I uu:file duu:file d:uu:file I 



where "d" is a drive letter (A-P) , "uu" is a 
user number (0-31) and "file" is a file name. 



5-1 



TurboDOS 1.4 COMMANDS 

User's Guide 

ALTSEC Command 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

ALTSEC Command ALTSEC is an IMS V7inchester alternate sector 

utility which allows bad sectors to be 
assigned to the alternate sector table on 
IMS Winchester drives that use the model 1100 
DMA Winchester controller. 



Syntax 



ALTSEC 



Explanation The ALTSEC program contains an option 

allowing examination of the alternate sector 
table on a Winchester, and an option allowing 
verification of tracks on the Winchester. 

The ALTSEC program will sign-on and display 
the program name and revision number. The 
user will be prompted for the physical 
Winchester drive unit number. (Unit is 
the first Winchester drive on a system, unit 
1 the second, etc.). 

The user will be asked to select on of 4 
options. These are: 
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Options 



Option 



Explanation 



Display the alternate sector 
table. Displays all the 
currently assigned in the 
alternate sector table on the 
Winchester drive. 

Assign a sector to the 
alternate sector table. The 
program attempts to recover 
the data in a bad sector. 

Verify a track and report 
errors. The number of errors 
that occurred reading each 
sector is displayed. This 
option is useful in determin- 
ing the exact location of bad 
sectors on particular tracks. 
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AUTOLOAD Command 



Syntax 



Explanation 



Example 



The AUTOLOAD command lets you set up a com- 
mand sequence to be executed automatically at 
each cold-start or warm-start. 



AUTOLOAD command { ! command} . . . 



If you wish, TurboDOS will automatically load 
any program or execute any command sequence 
at initial start-up (cold-start), or at the 
conclusion of each program you run (warm- 
start). If the file COLDSTRT.AUT exists on 
the start-up disk, TurboDOS will execute it 
automatically at each cold-start. If the 
file WARMSTRT.AUT exists on the current disk, 
TurboDOS will execute it automatically at 
each warm-start. 

You can use the AUTOLOAD command to create 
these .AUT files. The command tail consists 
of the command(s) to be executed automatical- 
ly. Note that if multiple commands are 
given, they must be separated with the deli- 
miter I rather than \. 

The AUTOLOAD command always creates a file 
named AUTOLOAD.AUT on the current drive under 
the current user number. By renaming this 
file as COLDSTRT.AUT or WARMSTRT.AUT, you 
will cause the specified command(s) to be 
executed automatically at each cold-start or 
warm-start. A newly created .AUT file does 
not affect system operation until the next 
system start-up. 



QA I AUTOLOAD DATE SET I BASIC MENU 

Auto load file created 

QAl RENAME AUTOLOAD.AUT COLDSTRT.AUT 

OA: AUTOLOAD. AUT renamed OA: COLDSTRT.AUT 
OA} 
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Error Messages 



I Error creating auto load file 



Patch Points I Z 8Q I ^086 i Va l_J ^£5£j:lpilQii I 

I I 

I 103H CS+4 "I" Special delimiter I 
I 104H CS+5 "\" Normal delimiter I 
I I 
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BANK Command 



Syntax 



Explanation 



Examples 



In a banked Z80 system, the BANK command lets 
you change from bank-switched to non-bank- 
switched operation, and vice versa. 




The first form selects the non-bank-switched 
mode of operation in which the TPA resides in 
memory bank (along with TurboDOS). There 
must be sufficient free memory in bank for 
at least a minimal TPA, otherwise an error is 
diagnosed and bank 1 remains active. 

The second form selects the bank-switched 
mode in which the TPA occupies bank 1. The 
third form displays the current bank mode. 

The BANK command has no effect in a non- 
banked system, and always shows that bank 
is selected. Use of this command is restric- 
ted to privileged log-ons only. 



QA} BANK 

Current bank number: 1 

OA} BANK 

Current bank number: 

0A> 



Error Messages 



I Invalid bank number requested 
I Insufficient memory in bank 
I Non-privileged user 
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The BATCH command provides a convenient way 
of entering TurboDOS command strings into a 
FIFO for processing by a dedicated batch 
processor in a networking system. 



Syntax 



Explanation 



Example 



BATCH command { I command} . . . 



To make use of the BATCH command, you must 
have previously set up a FIFO with the stan- 
dard name BATCH. DO; in most cases, this FIFO 
should be set up as a global file under user 
number on drive A, and should have the 
"suspend" option selected (see FIFO command). 
The batch processor executes the command "DO 
BATCH" (usually autoloaded) at system start- 
up. Thereafter, any command string written 
to the FIFO will wake up the batch processor 
and be executed. Whenever the FIFO becomes 
empty, the batch processor will be suspended 
awaiting additional work to do. 

You can use the BATCH command to write any 
command or string of commands to the FIFO. 
If multiple commands are given in the BATCH 
command tail, they must be separated with the 
delimiter I rather than \. BATCH writes the 
command (s) to BATCH. DO, converting each I to 
a \ and prefixing the command string with 
commands to select the proper drive and user 
number. 



50 BATCH PASM PROG I RELCVT PROG 

Message sent to FIFO 

5C} 



The command above writes the following text 
to BATCH. DO: 

5C:\PASM PROG\RELCVT PROG 
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Error Messages 



Patch Points 



BATCH. DO FIFO not found 
BATCH. DO file not FIFO 
BATCH. DO FIFO is full 
Excessive command length 











Z80 1 


8086 1 


Val 


i Description 


103H 
104H 
105H 


CS+4 
CS+5 
CS+6 


II 1 II 
II \ II 




Special delimiter 
Normal delimiter 
Drive for BATCH. DO 
(0=A, 1=B,..., 15=P) 
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BOOT Command 



Syntax 



The BOOT command lets you access any reserved 
tracks ("boot tracks") on a disk. 



BOOT s: destfile 
BOOT srcefile d: 
BOOT s: d: 



Explanation 



Some hardware configurations require that 
certain tracks on a disk be reserved (e.g., 
for a cold-start loader or alternate track 
table). The BOOT command provides a means 
for reading, writing, or copying such re- 
served tracks. 

The first form reads the reserved tracks from 
the source drive "s:" and writes the data to 
the destination file "destfile". The 
second form reads a source file "srcefile" 
and writes the contents to the reserved 
tracks on destination drive "d:". The last 
form copies the reserved tracks from source 
drive "s:" to destination drive "d:". 

The BOOT command reads the entire source 
(tracks or file) into memory before writing 
the data out to the destination (tracks or 
file). If the source is too big to fit into 
the TPA, you will get an error message. 

The disk(s) containing boot tracks to be read 
or written must be attached to the processor 
in which the command is executed. In a Z80 
banked-memory system, the command must be 
executed from bank 0. Use of the BOOT com- 
mand is restricted to privileged log-ons. 
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Examples 



Error Messages 



0A} BOOT B: BOQTSAVE.SYS 
Reading boot tracks: *** 
Writing destination file: 
Operation successful 
0A} BOQT BOOTCQDE.SYS B: 
Reading source file: .... 
Writing boot tracks: *** 
Operation successful 
0A} BOOT B: A: 
Reading boot tracks: *** 
Writing boot tracks: *** 
Operation successful 
OA} 



Non-privileged user 

No source drive/filename specified 

No destination drive/filename specified 

Can't find source file 

Can't read boot tracks 

Can't write destination file 

Can't write boot tracks 

Not enough memory 

Unable to execute from bank 1 
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BUFFERS Command 



Syntax 



Explanation 



Example 



The BUFFERS command lets you change the 
number and/or size of disk buffers maintained 
by TurboDOS. 



I 

I BUFFERS (Nnumber) (Ssize) 



The BUFFERS command sets the number of buf- 
fers to "number" and the buffer size to 
"size". The minimum number of buffers al- 
lowed by TurboDOS is 2. The buffer size is 
given in decimal bytes, and must be one oi 
the following: 128, 256, 512, 1024, 2048, 
4096, 8192, or 16384. The buffer size should 
not be smaller than the physical sector size 
of the disks being used. 

If there is not enough memory to allocate the 
requested number of buffers of the specified 
size, the BUFFERS command will allocate as 
many as it can. If either the "N" or "S" 
argument is omitted, the corresponding para- 
meter remains unchanged. If both are omit- 
ted, the command simply displays the current 
parameters. 

The use of the BUFFERS command to change 
buffer parameters is restricted to privileged 
log-ons only. In a networking system, if the 
BUFFERS command is executed in a slave pro- 
cessor without any local disk storage, then 
it refers to the buffer pool in the master 
processor. 



OA} BUFFERS N6 
Number of buffers: 6 
Length of buffers: 1024 
OA} 
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Error Messages 



Non- privileged 


user 1 


Minimum number 


of buffers = 2 1 


Maximum number 


of buffers = 255 1 


Invalid buffer 


size requested 1 
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CHANGE Command 



Syntax 



Explanation 



Options 



Examples 



Error Messages 



You must use CHANGE before removing a disk 
from any drive on a multi-user system. 



I CHANGE {drivelist} 



The command tail consists of a list of drive 
letters A.. .P corresponding to the disks that 
you want to change, or an asterisk * if you 
want to change all disks. If you omit the 
drive list, CHANGE will prompt you for it. 
Before shutting down a multi-user TurboDOS 
system, it is a good idea to enter the com- 
mand "CHANGE *". 

If any of the drives you request are in use 
by another user, your request will be denied. 
Otherwise, you will be prompted to change the 
requested disk(s), and to enter RETURN when 
you are done. Until you have pressed RETURN, 
no other user will be allowed to access the 
disk(s) that you are changing. 



Option 1 


Explanation 




;N Pause f( 


Dr RETURN is bypa 


ssed. 


OA} CHANGE BCD 






Change drive (s) 


BCD 




Enter <CR> when 


change complete 


[RETURN] 


A} CHANGE * :N 






Change drive (s) 


ABCDEFGHIJKLMNOP 




OA) 









Invalid drive (s) requested 
Following drive(s) in use: d. 
Unable to free drive(s): d. . . 
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CLOCK Command 



The CLOCK command is used to read or set the 
date and time stored in the real time clock 
on your IMS system. 



Syntax 



Explanation 



CLOCK ; options 



The CLOCK command will allow the user to read 
and display the time and date, display the 
time in military time, set the time, or view 
the time continuously. The user must be 
attached to the master to use this command 
(See the MASTER command) . In systems with 
banked memory, CLOCK must be executed in a 
single-user, non-banked configuration. 

NOTE: After changing date and time, the 
DATE command must be executed to update 
TurboDOS' internal day-month-year hour- 
minute-second-tick counters. See DATE 
command in this chapter. 



Options 



1 Option 


1 Explanation 


1 ;R 


Read and display the time and 
date. 


1 ;M 


Military time. 


1 ;S 


Set the time. 


1 ;V 
1 every 


View time continuously, updating 
second. 
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Error Messages 



Can't read the clock chip 

Invalid option specified 

Invalid entry 

Must attach to the master to run CLOCK 
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COPY Command The COPY command lets you copy individual 

disk files or groups of files. 



Syntax I 

I COPY srcefile destfile {;options} 
I COPY {; options) 



Explanation The COPY command makes a copy of the file 

specified by "srcefile". The new file is 
created on the drive and with the filename 
specified by "destfile". 

You may use wild-card characters (? and *) in 
the "srcefile" argument to indicate that 
multiple files are to be copied. Wild-card 
characters may also be used in the "destfile" 
argument to indicate that the corresponding 
characters of each source filename are to be 
used in the destination filename. 

If you give a "srcefile" or "destfile" argu- 
ment consisting of only a drive letter and/or 
user number prefix, COPY assumes a filename 
of all wild cards (in other words, C: is 
equivalent to C:*.*). 

If you omit both "srcefile" and "destfile" 
from the command (second form), then the COPY 
command operates in an interactive mode. You 
are prompted by an asterisk * to enter a 
series of directives from the console. The 
syntax of each directive is: 



I 

I srcefile destfile {;options} 



Options specified within a directive take 
precedence over options specified in the COPY 
command itself. A null directive (RETURN 
only) terminates the COPY command. 
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Options 



Option I. 



Explanation 



;A Only source files without the 

"archived" attribute are copied. 
These source files are given the 
"archived" attribute after they 
are copied. This provides a 
means for incremental backup of 
large disks. 

;B Allows a large source file to be 
copied in sections to multiple 
destination disks, or to restore 
such a file from multiple source 
disks. If this option is speci- 
fied, the "srcefile" argument 
cannot contain wild cards. 

;C If the destination fills up, 
COPY allows you to change the 
disk in the destination drive 
and continue copying. This is 
useful when backing up a hard 
disk to floppy disks. 

;E COPY erases each source file 
after copying to destination. 

;N If "srcefile" contains wild 

cards, COPY does not ask you for 
confirmation before copying each 
file. If a destination file al- 
ready exists, COPY does not ask 
you for confirmation before de- 
leting it. 

;R COPY replaces files on the des- 
tination disk, but doesn't copy 
files that don't already exist 
on the destination disk 
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Options 
(Continued) 



Examples 



Option 



■Explanation 



;X 



Copying is not performed if the 
destination file already exists 

If "srcefile" contains wild 
cards, COPY asks you for confir- 
mation before copying each file 
If a destination file already 
exists, COPY asks you for con- 
firmation before deleting it. 



0A} COPY *.BAS B; ;N 

OArAMORTIZE.BAS copied to OB: AMORTIZE. BAS 

OA: PRIMES .BAS copied to OB: PRIMES .BAS 

OB:STARTREK.BAS already exists, deleted 

OA:STARTREK.BAS copied to OB: STARTREK. BAS 

0A} COPY 

* AUT0L0AD.COM B; ;E 

OA: AUTOLOAD. COM copied to OB: AUTOLOAD. COM 
OA: AUTOLOAD. COM deleted 

* [RETURN] 
OA} 

and for privileged log-ons: 



QA} CQPY *.DAT 7B: ; NE 



OA: STOCKS 
OA: STOCKS 
OA: BONDS 
OA: BONDS 
OA) 



.DAT copied to 7B: STOCKS 

.DAT deleted 

.DAT copied to 7B: BONDS 

.DAT deleted 



.DAT 
.DAT 
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Error Messages 



Invalid filename 1 
Invalid filename 2 
Ambiguous filename not permitted with 

option B 
Destination drive read-only 
<filename> copy to same filename 
<filename> FIFO file, not copied 
File not found 

Unable to lock destination drive 
Unable to free drive 
Unable to open source file 
Unable to create destination file 
Unable to read source file 
Unable to write destination file 
Unable to close source file 
Unable to close destination file 
Unable to set attributes on source file 
Unable to set attributes on destination 

file 
Insufficient memory 
Non-privileged user 
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COPYF Command 



Syntax 



Explanation 



The COPYF command performs a fast copy of an 
entire disk onto another disk of the same 
type and format, and is generally used to 
backup floppy diskettes. 



COPYF s: d: 



COPYF performs a track-by-track copy of the 
source disk "s:" on to the destination disk 
"d:". Both diskettes must be of exactly the 
same type and format. The user must be 
attached to the master processor (see the 
MASTER command) . In banked memory systems, 
COPYF must be run in a single-user, non- 
banked configuration. 



Example 



OAl COPYF A: B: 

PROG ID: COPYF 

IMS INTERNATIONAL 

Copy Floppy Disk Utility 

. . . parameters displayed 
Source drive: A 
Destination driver: B 
<cr> to continue or '^C 
[RETURN] 
Copyingcylinder x 

Copy complete — 



Revision 2.0 



to abort 
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Error Messages 



Non-privileged user 
No source drive specified 
No destination drive specified 
Unable to lockout source drive 
Unable to lockout destination drive 
Source drive not ready 
Destination drive not ready 
Disk types not identical 
Insufficient memory for copy 
Read error. Drive: d. Track: nn 
Write error. Drive: d. Track: nn 
Unable to execute from bank 1 
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DATE Command 



Syntax 



The DATE command lets you set or display the 
system date and time. 



I 

I DATE (SET} 



Explanation 



Examples 



If "SET" is specified, the DATE command 
prompts you interactively to enter the new 
system date and time. The required format 
for the date is "dd mmm yy"/ and for the time 
"hh:mm:ss" (see Examples). You may leave the 
date or time unchanged by typing RETURN in 
response to the prompt. 

If "SET" is not specified, the DATE command 
simply displays the current system date and 
time. 



OA}D AT E S ET 

Date: 07 Dec 41 

Time: 1 6;1^;0Q 

A) DATE 

Date: 07 Dec 41 

Time: 16:15:08 

OA) 
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DELETE Command 

Syntax 

Explanation 



Options 



The DELETE command lets you delete individual 
disk files or groups of files. 



DELETE filename {; options} 
DELETE {; options} 



The DELETE command permanently deletes the 
file specified by "filename" from disk. 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
multiple files are to be deleted. 

If you omit "filename" from the command 
(second form) , then the DELETE command oper- 
ates in an interactive mode. You are promp- 
ted by an asterisk * to enter a series of 
directives from the console. The syntax of 
each directive is: 



I filename {; options} 



Options specified within a directive take 
precedence over options specified in the 
DELETE command itself. A null directive 
(RETURN only) terminates the DELETE command. 



Option I 



E xpla nat ion 



;N If "filename" contains wild 

cards, DELETE does not ask you 
for confirmation before deleting 
each file. 

;Y If "filename" contains wild 

cards, DELETE asks you for con- 
firmation before deleting each 
file. 
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Examples 



Error Messages 



0A:AMORTIZE.BAS deleted 

0A:PRIMES . BAS deleted 

OA:STARTREK.BAS deleted 
0A} DELETE B:MAXI*.* ;Y 

OB: MAXICOMP.TXT OK to delete (y/n) ? E 

0B:MAXIMUMS.COM OK to delete (y/n)? X 

OB: MAXIMUMS. COM deleted 

OB:MAXIMUMS.ASM OK to delete (y/n)? X 

OB: MAXIMUMS. ASM deleted 
OAlDELETE 

* AUT0L0AD.COM 

OA: AUTOLOAD. COM deleted 

* *.TXT ;N 
OA:REFERENC.TXT deleted 
OA:USERGUID.TXT deleted 

* [RgT URN] 
OA) 

and for privileged log-ons: 

OAl DELETE 7P;*.P AT ;N 

7B: STOCKS .DAT deleted 

7B:B0NDS .DAT deleted 
OA) 



Destination drive read-only 
<filename> read-only, not deleted 
<filename> FIFO file, not deleted 
File not found 
Invalid filename 
Insufficient memory 
Network error 
Non-privileged user 
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DIR Command 



Syntax 



Explanation 



The DIR command displays an alphabetized disk 
directory on the console or printer. 



DIR filename {;options} 
DIR prefix: {;options} 
DIR {;options} 



The "filename" argument generally contains 
wild-card characters (? and *) , and specifies 
the user number, drive letter, and group of 
files to be included in the directory. If 
you specify only a drive letter and/or user 
number prefix (second form), all files on the 
specified drive/user are displayed. If you 
omit the filename argument altogether (third 
form), all files on the current drive/user 
are displayed. 

In all cases, the directory display starts 
out with a preamble containing the following 
information: 

. user number, drive, and "filename" 

. disk label 

. current date and time 

. hashed directory indicator: (H) 

. free space remaining on disk 

. number of files displayed 

. combined size of files displayed 

This preamble is followed by an alphabetized 
list of filenames, with the size of each file 
shown. Read-only files are distinguished by 
a colon : (rather than a period .) between 
the filename and filetype. 

If there are too many files to fit on the 
screen, DIR waits at the end of each screen- 
full for you to press RETURN. 
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Options 



Examples 



Error Messages 



Patch Points 



Option. 



■ilxpl ana tioiL 



;L 



The directory is printed rather 
than displayed on the console. 



OA}D XR ; L 

...(printout of all OA: files)... 

OAlD IR P; 

...(display of all OB: files)... 

OA) 

and for privileged log-ons: 

OAl DIR 5; 

. . . (display of all 5A: files) . . . 

OAl DIR 7B;*.DAT 

...(display of only 7B:*.DAT files) 

OA} 



Insufficient memory 
Network error 
Non-privileged user 



Z80 



80 86 I VM. 



■Dgscrip tio n- 



103H CS+4 
104H CS+5 



3 



Left margin for ;L opt 
Clear-screen character 
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DO Command 



Syntax 



Explanation 



The DO command lets you execute a pre-defined 
sequence of TurboDOS commands which you have 
previously saved in a disk file. 



DO filename (argl arg2 ... argN) 



The "filename" argument specifies the file of 
TurboDOS commands to be executed (called the 
"do-file"). If "filename" does not specify 
an explicit filetype, then .DO is assumed. 
The DO command causes the commands contained 
in the do-file to be executed in sequence. A 
do-file may contain embedded DO commands, and 
TurboDOS supports such "nesting" of do-files 
to any reasonable depth. 

The optional arguments "argl" through "argN" 
are substituted into marked locations in the 
do-file. Any number of arguments is permit- 
ted. If arguments contain embedded spaces, 
they must be enclosed in single or double 
quotes. The presence of one or more of these 
arguments causes the DO command to make a 
temporary copy of the do-file in which the 
arguments are substituted as required. The 
commands in the temporary file are then exe- 
cuted in sequence. The temporary file is 
given the same filename as the original do- 
file, except that the last character of the 
filetype is changed to a dollar sign (e.g., 
GENERATE. DO is copied to GENERATE. D0$) . The 
last entry in the temporary file is a DELETE 
command which causes the temiporary file to be 
deleted. 

The do-file is simply a text file, each line 
of which contains a valid TurboDOS command or 
command string. You can create do-files with 
any text editing program. 
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Explanation 
(Continued) 



Examples 



Error Messages 



Patch Points 



If argument substitution is desired, then you 
must mark each substitution point in the do- 
file by enclosing the argument number in 
braces (}. For example, (3) in the do-file 
will be replaced by the value of "arg3" of 
the DO command. A default value may follow 
the argument number, separated by a comma 
({3, TEMP} for example), and will be used if 
the corresponding argument of the DO command 
is missing or null. 

Note that if a do-file contains such marked 
substitution points, then the invoking DO 
command musi contain at least one substitu- 
tion argument to trigger the substitution 
process. A null argument such as "" or '' is 
sufficient. 

Certain commands (such as COPY, RENAME and 
DELETE) and other programs expect interactive 
input from the console. If such a command or 
program is executed within a do-file, then 
its console input comes from the do-file 
rather than the console (in most cases). 

If the last entry in a do-file is a DO com- 
mand that reinvokes the same do-file, the 
trailing RETURN/LINEFEED should be omitted to 
avoid recursion that is nested too deeply. 

See preceding section on Batch Processing for 
examples of the DO command. 



Unable to activate DO file 
Non-privileged user 



Z80 I 8086 I Val I 



-D.escj:.ip.tJ-on. 



103H 
104H 



CS+4 
CS+5 



"{" Left param delimiter 
"}" Right param delimiter 



5-28 



TurboDOS 1.4 
User's Guide 



COMMANDS 
DRIVE Command 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



DRIVE Command 



Syntax 



Explanation 



Options 



Example 



Error Messages 



The DRIVE command displays information about 
the format of a disk. 



DRIVE {d:} {;options} 



The DRIVE command displays the format of the 
disk specified by the "d:" argument, as shown 
in the example below. If you omit the "d:" 
argument, then the format of the disk in the 
current drive is displayed. The display may 
be on the console or printer. 



Option 1 Explanation 1 


1 
;L The disk format information is 1 


printed, rather than displayed 1 


on the console. 


1 
1 


OA}DRIVE B: 


1 
1 


Disk format, drive B: DOCUMENT. TXT 1 


Maximum data capacity : 


1224K 1 


Allocation block size : 


2K I 


Number of directory entries: 


1024 1 


Physical sector size : 


1024 1 


Physical sectors per track : 


16 1 


Physical tracks per disk : 


77 1 


Number of reserved tracks : 


1 


Removable media 


1 


OA} 


1 
1 


Network error 


1 
1 
1 
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DUMP Command 



Syntax 



Explanation 



The DUMP command displays a combined hexa- 
decimal and ASCII file dump on the console or 
printer . 



DUMP filename {;options} 



The DUMP command displays the contents of the 
file specified by "filename" in both hexa- 
decimal and ASCII formats. The dump may be 
directed to either the console or printer. 



Options 



Examples 



Error Messages 



Option I 



Explanation 



;L The dump is printed, rather than 
displayed on the console. 



OAl DUMP B; DUMP. COM 

...(hex/ASCII dump of OB:DUMP. COM) . 

OA} 

and for privileged log-ons: 

QA} DUMP 7B;B0NDS.DAT 

...(hex/ASCII dump of 7B:B0NDS.DAT) 

OA} 



File not found 
Non-privileged user 
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ERASEDIR Command The ERASEDIR comitiand lets you erase the 

entire directory of a disk. 



Syntax I 

I ERASEDIR d: 
I 



Explanation The ERASEDIR command erases all files on the 

disk specified by the "d:" argument, regard- 
less of user number or read-only attributes. 
It also lets you specify whether the newly- 
initialized directory should be maintained in 
linear or hashed format. 

WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 

Use of the ERASEDIR command is restricted to 
privileged log-ons only. 



Example I I 

I OA} ERASEDIR B: I 

I Hashed directory desired (Y/N) ? Y 1 

I OK to erase directory on drive B (Y/N) ? Y I 

i Erasing directory I 

I Directory erased, hashed I 

I OA} I 



Error Messages I I 

I Non-privileged user I 

I No drive specified I 

I Unable to erase directory I 
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FIFO Command 

Syntax 

Explanation 



Examples 



Error Messages 



The FIFO command lets you create FIFO files 



FIFO filename 



FIFO's are special files supported by 
TurboDOS to facilitate communications between 
users and processors. More details may be 
found in the TurboDOS Program.mers Guide. 

If the FIFO identified by "filename" already 
exists, then the FIFO command displays its 
characteristics. Otherwise, the FIFO command 
prompts you interactively for the necessary 
parameters to create a new FIFO. 



OAI FIFO B: BATCH. DO 

FIFO file not found, creating new file 

Enter FIFO type (Ram/Disk) : I^ 

Suspend processing on full/empty (Y/N) : Y 

Enter max nbr of records (1-65535): 1000 

FIFO file created 

A} FIFO B: BATCH. DO 

FIFO is Disk resident 

FIFO does suspend process on full/empty 

Maximum number of records: 1000 

Current number of records: 

OA) 



No FIFO file name specified 
File not FIFO 

Unable to create FIFO file 
Unable to read FIFO file header 
Non-privileged user 
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FIXDIR Command 



Syntax 



Explanation 



The FIXDIR command lets you reorganize a disk 
directory whenever frequent additions and 
deletions of files have caused directory 
access to become less efficient. FIXDIR also 
lets you convert a disk directory from linear 
to hashed or vice-versa. 



I FIXDIR d: 



The FIXDIR command reorganizes the directory 
on the disk specified by the "d:" argument. 
It also lets you specify whether the newly- 
reorganized directory should be maintained in 
linear or hashed format. 

For linear directories, FIXDIR eliminates all 
deleted entries and compresses all directory 
entries at the beginning of the directory 
area. For hashed directories, FIXDIR re- 
hashes each entry to ensure optimum access 
efficiency. 

You cannot use FIXDIR on a drive that is in 
use by another user. Use of the FIXDIR com- 
mand is restricted to privileged log-ons 
only. 

WARNING: Execution of FIXDIR cannot be 
interrupted by an "attention" from the con- 
sole. Any attempt to abort via hardware 
reset is likely to result in loss of one or 
more files. It is a good idea to make a 
backup copy of the disk before using FIXDIR. 

WARNING: If conversion from linear to hashed 
format (or vice-versa) is requested, FIXDIR 
may take a long time (in extreme cases, 
hours). Do not attempt conversion unless 
adequate time is available to complete the 
operation. Also, it is wise to make a backup 
copy of the disk before using FIXDIR. 
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Explanation WARNING: Conversion from linear to hashed 
(Continued) format may occasionally require more than one 

FIXDIR pass to ensure proper hashing of all 
directory entries. If you encounter trouble 
accessing certain files after conversion to 
hashed format, simply run FIXDIR again. 



Example 



Error Messages 



OAI FIXDIR B; 

Hashed directory desired (Y/N) ? Y 

OK to reorganize directory on drive B? Y 

Reorganizing directory-DO NOT INTERRUPT 

Directory reorganized, hashed 

OA) 



Non-privileged user 

No drive specified 

Unable to reorganize directory 
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FIXBIAP Command 



Syntax 



Explanation 



Examples 



The FIXMAP command lets you regenerate the 
allocation map for a disk. 



FIXMAP d: 



In order to keep track of which blocks of 
disk space are occupied and which are free, 
TurboDOS maintains on each disk an allocation 
map for that disk's space. Certain program 
malfunctions (failure to close a newly- 
created file, for example) can create dis- 
crepancies between the allocation map and the 
directory of a disk. The result is that disk 
blocks may occasionally become unavailable. 

The FIXMAP command regenerates the allocation 
map on the disk specified by the "d:" argu- 
ment, thereby reclaiming any disk blocks that 
may have become unavailable in this fashion. 

You cannot use FIXMAP on a drive that is in 
use by another user. Use of the FIXMAP com- 
mand is restricted to privileged log-ons 
only. 



OAl FIXMAP B: 

OK to regenerate disk map on drive B? Y 

Regenerating disk map 

Disk map regenerated 

QA} FIXMAP C; 

OK to regenerate disk map on drive C? Y 

Regenerating disk map 

Disk map regenerated, 3 blocks gained 

OA) 
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Error Messages 



Unable to regenerate disk map 
Non-privileged user 
No drive specified 



5-36 



TurboDOS 1.4 
User's Guide 



COMMANDS 
FMTF Command 



Copyright 1984 by Software 2000, 
All rights reserved. 



Inc. 



FMTF Command 



Syntax 



Explanation 



Options 



You must use the FMTF command to pre-record 
format information on each new disk before it 
is used for the first time. 



FMTF d: {; options) 



The FMTF command initializes and then veri- 
fies the disk identified by "d;", which must 
be attached to the processor in which the 
command is executed. Useof the FMTF command 
is restricted to privileged log-ons only. In 
systems with banked memory, FMTF must be run 
in a single-user, non-banked configuration. 

WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 

If the hardware supports multiple disk for- 
mats, the FMTF command may require certain 
hardware-dependent options to specify the 
particular format desired. If you don't 
include all of the necessary options in the 
command, then FMTF will prompt you for them 
interactively. The examples below are typi- 
cal for floppy disks. 



Op t io n J- 



Explanation 



C CP/M Sector size 

T TurboDOS sector size 

S Single-density 

D Double-density 

1 Single-sided 

2 Double-sided 
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Options 
(Continued) 



Example 



Option 



Explanation 



;V FMTF performs only the verify 
pass (and omits the formatting 
pass) . 

;4 40-track minifloppy (48 tpi) 

;8 80-track minifloppy (96 tpi) 



Revision 2.0 



D 



OAl FMTF B; 

PROG ID: FMTF 

IMS INTERNATIONAL 

Floppy Disk Format Utility 

TurboDOS or CP/M format (T/C) ? T. 

Single- or double-density (S/D)? ___ 

One- or two-sided (1/2)? 2 

Selected sector size type: T 

Selected density: D 

Selected number of sides: 2 

FMTF will format diskette in drive B 

Type <CR> to continue, <CTRL-C> to abort 

? [RETURN] 

Formatting cylinder xx 

— Format complete — 
Verifying cylinder xx 

— Verify complete — 
OA} 
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Error Messages 



Non-privileged user 
Unable to lockout format drive 
Insufficient memory to verify 
Invalid drive specified 
Specified drive is not a floppy drive 
Drive is single-sided, unable to format 
double sided 
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FMTW Command The FMTW command is used to pre-record format 

information on each new Winchester disk be- 
fore it is used for the first time. 



Syntax 



FMTW d: 



Explanation The FMTW command initializes and then veri- 
fies the disk identified by "d:", which must 
be attached to the processor in which the 
command is executed (See the MASTER command) . 
FMTW also records the bad sectors on the 
disk. Use of the FMTW command is restricted 
to privileged log-ons only. In systems with 
banked memory, FMTF must be run in a single- 
user, non-banked configuration. 

This program will ask for a list of bad 
sectors. The list can be found on the side 
of the drive. FMTW will mark the bad sectors 
and check if there are any more. FMTF will 
list the bad sectors on the console or a 
printer. If there are more than 17 sectors 
on an 8" drive or 18 bad sectors on a 5" 
drive, the rest of the bad sector list should 
be entered using the WALT command. 

This command can be aborted by typing a 
control-C. 

WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 
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Example 



Error Messages 



Revision 1.0 



OA} FMTW Bi 

PROG ID: FMTW 

IMS INTERNATIONAL 

Winchester Format Utility 

More than one logical unit(Y/N)?E. 

Any bad sectors (Y/N) ?M 

Enter <CR> to begin formatting: [RETURN] 

Formatting cylinder xx 

— Format complete — 
Verifying cylinder xx 

— Verify complete — 

— No bad sectors — 
OA} 



Non-privileged user 

Unable to lockout format drive 

Insufficient memory to verify 

Invalid drive specified 

Specified drive is not a Winchester 
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Syntax 



FMTWIN Command FMTWIN is an IMS Winchester format utility 

used for formatting IMS Winchester drives 
with IMS model 1100 DMA Winchester 
controllers. This program must be run on a 
single-user system. 



FMTWIN 



Explanation This program formats and verifies IMS 

Winchester disk drives. The program will 
sequentially format every track on the drive, 
and then sequentially verify every track. 
Verification consists of performing reads, 
verifying the data was read successfully, 
and reporting any errors encountered. 

Bad sectors assigned by the user are 
recorded and written on Track (in a "bad 
sector table", also known as "alternate 
sector table") , along with the physical 
drive specifications at the end of verifi- 
cation. 

The program contains an option allowing 
verification of previously formatted drives, 
and an option allowing drive specifications 
and bad sector information of previously 
formatted drives to be examined. 
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Options 



Option 



Explanation 



Format and verify option will 
examine the Winchester and 
determine if the drive has been 
previously formatted with this 
utility. 

Verify drive only option will 
examine the drive to see if it 
is formatted. 

Display drive specifications 
and Bad Sector Table. The 
program will examine the drive 
to see if it is formatted and 
display the Bad Sector Table 
if the drive is formatted. 

Exit utility. 
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LABEL Command 



Syntax 



Explanation 



Ex ample 



The LABEL cofnmand: JlBts put a volume label on 
a disk. 



LABEL .^filename 



The LABEL command writes a new volume label 
on the disk identified in the "filename" 
argument (or the current drive if no drive 
letter is specified explicitly). The name 
and type fields of "filename" are used as the 
volume label. The volume label may be dis- 
played using the DIR or DRIVE commands. 



I A) LABEL B; PAYABLES.DAT 

I Disk label written 

I OAl DRIVE B: 

! Disk format, drive B: PAYABLES.DAT 

I ... (etc*) . . . 

I OA) 



Error Messages 



Unable to label disk 
Invalid disk label 
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LOGOFF Command 

Syntax 

Explanation 



Examples 



In a multi-user system, the LOGOFF command 
lets you terminate your session. 



LOGOFF 



Executing the LOGOFF command has the follow- 
ing effects; 

. current user number is set to 31 
. current drive is set to system disk 
. access to global files is inhibited 

The library for user number 31 normally con- 
tains only the LOGON command file and the 
USERID.SYS validation file (see LOGON com- 
mand). Consequently, no further activity can 
be performed until a successful LOGON has 
taken place. 

If the file SYSLOG.SYS is also present in the 
user 31 library, then LOGOFF automatically 
records the log-off in that file. 

^ . ^ 

I 5O LQG0FF I 

I 31A} I 



Error Messages 



Unable to log off 



5-45 



TurboDOS 1.4 
User's Guide 



COMMANDS 
LOGON Command 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



LOGON Command 



Syntax 



Explanation 



In a multi-user system, the LOGON command 
lets you start a new console session. 



LOGON 



The LOGON command provides password-type 
security for the purpose of protecting pri- 
vate file libraries and preventing unauthor- 
ized access to the system. 

The LOGON command prompts you interactively 
to enter your user-id, and validates whatever 
you enter against a validation file called 
USERID.SYS in the user 31 library. This file 
is an ordinary text file which may be created 
with any text editing program, and contains 
an entry of the following format for each 
valid user-id: 



I userid, (password) ,uu{P} , (d: }, (cmdline) I 



where "userid" and "password" are up to eight 
characters in length, "uu" is a user number 
(0-30), "d:" is a drive letter (A-P) , and 
"cmdline" is any valid TurboDOS command line. 

If your user-id has an associated password 
specified in USERID.SYS, then the LOGON com- 
mand prompts you to enter a password, and 
validates it. If your user-id and password 
are both found to be valid, then the log-on 
succeeds. A successful log-on has the fol- 
lowing effects: 

access to global files is enabled 
"nn" sets current user number 
"P" sets privileged user (if present) 
"d:" sets current drive (if present) 
"cmdline" is executed (if present) 
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Explanation 
(Continued) 



Example 



Error Messages 



Patch Points 



If the system date and time have not been set 
since start-up, LOGON prompts for and sets 
the date and time. 

If the file SYSLOG.SYS is present in the user 
31 library, then the LOGON command automa- 
tically records your log-on in that file. In 
this case, LOGON prompts you for an activity 
description, and records it in the log entry. 

It is common practice to make a copy of the 
LOGON command under the name WARMSTRT.AUT in 
the user 31 library, which causes LOGON to be 
executed automatically at start-up and imme- 
diately after each LOGOFF. 



31A} LQG0N 
System log on 
Enter user id: Barbara 
Enter password: Shazam 
Enter date: 15 Apr 84 
Enter time: 14:25:30 
Enter activity: Payrol ] 
5C} 



Invalid user id 
Incorrect password 
Invalid date 
Unable to log on 



Z8Q I 80 86 I Val I 



■Descripti.QiL 



103H CS+4 



Clear-screen character 
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Syntax 



MASTER Command The MASTER command lets you temporarily 

attach your console to the "master" processor 
in a network system. 



I MASTER 



Explanation In many TurboDOS systems, disks and other 

shared peripherals are attached to a "master" 
or "server" processor which is separate from 
the "slave" processors to which user consoles 
are attached. If you need to run a program 
in the master processor (the BACKUP, BOOT, 
FORMAT or VERIFY commands, for example), you 
can use the MASTER command to assign your 
console to the master temporarily. To detach 
from the master (and resume normal console 
operation), enter an Attention/Abort sequence 
(typically CTRL-@/CTRL-C) . 

While attached to the master, you can send 
attention requests to the master processor by 
using a special attention character (CTRL-A) 
instead of the regular one (CTRL-@). 

Use of the MASTER command is restricted to 
privileged log-ons only. Do not attempt to 
run MASTER from more than one console at a 
time. If you do, console output from the 
m.aster will be randomly distributed across 
two or more consoles, and be undecipherable. 
If this should occur by mistake, simply de- 
tach all but one of the consoles. 

The MASTER command can be used only if the 
master processor operating system is confi- 
gured with a special remote console driver 
module CONREM. See the Impl^Hl^IlijQXla iiiiid^ 
for details. 
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Example 



Error Messages 



Patch Points 



Console attached to master processor 
A) FORMAT B: 



OA} [ CT R L-S ] [C TRL- C 3 

Console detached from master processor 

5C} 



Console already attached to master 

Non-privileged user 

Remote console driver not present 



Z80 I 8086 I Val 



De script j-QB. 



103H CS+4 
104H CS+5 



" A" Special attention char 
""@" Normal attention char 
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PRINT Command 

Syntax 

Explanation 



Options 



The PRINT command lets you control routing of 
your print output. 



PRINT {option}... 



The PRINT command may include one or more of 
the options described below. A PRINT command 
with no option arguments causes your current 
print routing to be displayed on the console. 
In a multi-user system, each user controls 
his own print routing independently. 



Option 



EitpljanatioiL 



CONSOLE Print output is routed to your 
C console (not to a printer) 



DRIVE=d 
D=d 



FILE 
F 



OFF 




Drive "d" is used for spooling, 
where "d" is a drive letter in 
the range A through P. 

Print output is spooled to disk, 
but not automatically queued for 
printing. 



Print output is discarded 



PRINTER=p 

P=p Print output is routed direct to 
printer "p" without spooling to 
disk, where "p" is a printer 
letter in the range A through P. 



QUEUE=q Print output is spooled to disk, 
Q=q and then automatically queued on 
queue "q" for printing, where 
"q" is a queue letter in the 
range A through P. 
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Examples 



Error Messages 



OA} PRINT DRIVE=C OUEUE=A 
Printing is to SPOOLER on DRIVE C 

to QUEUE A 
A) PRINT P=B 

Printing is to PRINTER B 
A} PRINT C 

Printing is to CONSOLE 
OAl PRINT 

Printing is to OFFLINE 
OA} 
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PRINTER Command 



Syntax 



The PRINTER command lets you control de- 
spooling on any selected printer. 



PRINTER p {option}... 



Explanation 



Options 



The "p" argument is a printer letter in the 
range A through P, and identifies the printer 
to be controlled. The PRINTER command may 
include one or more of the options described 
below. A PRINT command with no option argu- 
ments causes the current status of printer 
"p" to be displayed on the console. In a 
multi-user system, any printer may be con- 
trolled from any console. 



_Qpti.QnL 



BEGIN 
B 



GO 
G 

OFFLINE 




QUEUE: 
Q=q 



Eicpi.aii^ ti oii_ 



stop de-spooling to printer, and 
reposition current print job to 
start at the beginning again 
when de-spooling is resumed. 

Resume de-spooling to printer 
after STOP or BEGIN. 

Take printer offline at the end 
of current print job. No fur- 
ther de-spooled printing will be 
done, but printer is available 
for direct printing. 



De-spool to printer from print 
queue "q", where "q" is a queue 
letter in the range A through P. 
If printer is currently printing 
from another queue, the new as- 
signment takes effect at the end 
of the current print job. 
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Options 
(Continued) 



Examples 



Error Messages 



Option 



Explanatio n 



STOP stop de-spooling to printer, 
S pending subsequent GO or TERMI- 
NATE. 



TERMINATE 



Terminate the current print job, 
and continue with the next job 
in the queue. The terminated 
print file is not deleted, and 
may be manually requeued with 
the QUEUE command. 



OA) PRINT E R B OUg UE= A 

Printer B Assigned to QUEUE A 

OA} PRINTER B STOP 

Printer B Assigned to QUEUE A (Stopped) 

OA} 



Invalid request 
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PRTWIN Command PRTWIN is an IMS Winchester partitioning 

utility which allows physical Winchester 
drives to be divided into a user-selected 
number of logical partitions. The utility 
is for IMS Winchester drives that use the 
model 1100 DMA Winchester controller. 



Syntax 



PRTWIN 



Explanation The user will be prompted for the physical 

Winchester drive unit number. (Unit is the 
first Winchester drive on a system, unit 1 is 
the second, etc.). 

The program will examine the selected 
Winchester and display the current logical 
partitioning of the drive. It will either 
display the number of logical partitions or 
indicate the drive is partitioned into CP/M 
compatible partitions. 

WARNING: After displaying the current 
partitioning of the drive, the program will 
display a warning message indicating that 
changing the logical partitioning will 
destroy existing data on the drive. Data 
is lostwhen changing logical partitioning 
because file directory locations change with 
different partitioning, making it no longer 
possible to access files on the drive. 
Therefore the user should "back-up" or save 
any pertinent files onthe Winchesterbef ore 
changing its logical partitioning. 
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Next the program will prompt the user for the 
number of logical partitions be created. 
(The values are entered in decimal). 
Entering a value from 1 to 15, inclusive, 
will divide the drive into that many 
partitions. The drive will be divided into 
partitions of equal size. (Except the last 
partition, which will be whatever size is 
left) . 

After performing the partitioning, the 
program will display a message indicating the 
partitioning has been completed, and also a 
message reminding the user to use the 
ERASEDIR utility immediately after 
partitioning. 

The program will then cause the system to 
reboot. This is done so that TurboDOS will 
recognize the new logical partitioning of the 
drive. 

Next the user must run the TurboDOS ERASEDIR 
utility on all of the new logical partitions. 
This must be done because the directories of 
the new logical partitions contain data in 
the format of whatever the previous 
partitioning was, leaving the directories 
with invalid data. The ERASEDIR utility 
erases the invalid data in the directories. 
ERASEDIR must be run on each new logical 
partition. 

The logical partitioning information is 
stored on track of the Winchester. It is 
tored in a single byte, and contains a value 
of 255 decimal (FF hex) for CP/M compatible 
partitioning, or the actual numbwer of 
logical partitions on the drive. 
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PUTLDR Command 



PUTLDR is used to write the operating system 
loader program, 0SL0AD.COM, to the reserved 
tracks of device. 



Syntax 



PUTLDR 



Explanation 



The PUTLDR will 
the OSLOAD prog 
return in respon 
logged on drive 
for a destinat 
then be read int 
disk. A dot is 
read and written 
to the master pr 
mand) . 



ask for a source drive where 
ram can be found. A carriage 
se will cause the currently 
to be used. It will then ask 
ion drive. 0SL0AD.COM will 
o memory and written to the 
displayed for each sector 
The user must be attached 
ocessor (See the MASTER corn- 



Example 



Error Messages 



OA} PUTLDR 

Source drive; [RETURN] 
Destination drive: E. 
Reading loader into memory 

Writing to destination drive 



Write complete 
OA} 



Insufficient memory to load 
Drive n has an invalid LPB 
Drive is not ready 
OSLOAD not found 
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QUEUE Command The QUEUE command lets you manually queue 

print files (or any text file) for de-spooled 
printing. 



Syntax I I 

I QUEUE filename {;options} I 

I QUEUE {; options} I 

I I 

Explanation The QUEUE command queues the file specified 

by "filename" for de-spooled printing. 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
multiple files are to be queued. 

If you omit "filename" from the command 
(second form), then the QUEUE command oper- 
ates in an interactive mode. You are promp- 
ted by an asterisk * to enter a series of 
directives from the console. The syntax of 
each directive is: 



I I 

I filename {;options} 1 



Options specified within a directive take 
precedence over options specified in the 
QUEUE command itself. A null directive 
(RETURN only) terminates the QUEUE command. 
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Options 



Example 



Error Messages 



Op tion 



;S 



;Y 



EKPlan at ioB- 



;D Queued file(s) are to be deleted 
automatically after printing. 

;N If "filename" contains wild 

cards, QUEUE does not ask you 
for confirmation before each 
file is queued. 

;Q=q File(s) are queued on print 



queue "q", where 



"q" is a queue 



letter in the range A through P. 
(If this option is omitted, the 
queue specified in the last 
PRINT command is used.) 

Queued file(s) are to be saved 
after printing, not deleted- 
(If neither ;D nor ;S are speci- 
fied, then ;S is assumed.) 

If "filename" contains wild 
cards, QUEUE asks you for con- 
firmation before each file is 
queued. 



A) QUEUE -PRINT-.* ; NDO=A 
OA:-PRINT- .008 queued 
OA:-PRINT- .014 queued 
OA:-PRINT- .020 queued 

OA} 



No queue letter available 
Invalid queue letter requested 
File not found 
Invalid filename 
Insufficient memory 
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RECEIVE Command 

Syntax 

Explanation 



Example 



The RECEIVE command reads one record from a 
FIFO and displays it on the console. 



I RECEIVE filename 



The "filename" argument specifies the FIFO to 
be read. The RECEIVE command is useful where 
FIFOs are used as message mailboxes in a 
multi-user system. 

Note that RECEIVE displays only one record. 
To display or print the entire contents of a 
FIFO, use the TYPE command instead. 



I OA} RECEIVE MAILBOX. RWR 

I RONNIE: NEED TO MEET WITH YOU 

I OA} 



.TEDDY 



Error Messages 



No FIFO file name specified 
FIFO file not found 
File not FIFO 
FIFO file empty 
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RENAME Command The RENAME command lets you rename individual 

disk files or groups of files. 



Syntax 



RENAME oldname newname {; options} I 
RENAME {; options) I 
^__ I 



Explanation The RENAME command changes the name of the 

file specified by "oldname" to the new name 
specified by "newname". The "oldname" argu- 
ment may have a drive letter and/or user 
number prefix. 

You may use wild-card characters (? and *) in 
the "oldname" argument to indicate that mul- 
tiple files are to be renamed. Wild-card 
characters may also be used in the "newname" 
argument to indicate that the corresponding 
characters of the old filename are to be used 
in the new filename. 

If you omit both "oldname" and "newname" from 
the command (second form), then the RENAME 
command operates in an interactive mode. You 
are prompted by an asterisk * to enter a 
series of directives from the console. The 
syntax of each directive is: 



I oldname newname {; options} 
I . 



Options specified within a directive take 
precedence over options specified in the 
RENAME command itself. A null directive 
(RETURN only) terminates the RENAME command. 
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Options 



Examples 



Error Messages 



Option 



Explanation 



;N If "oldname" contains wild 

cards, RENAME does not ask you 
for confirmation before renaming 
each file. 

; Y If "oldname" contains wild 

cards, RENAME asks you for con- 
firmation before renaming each 
file. 



OA} RENAME B:*.RAK * . PRV ;N 
OB:REFERENC.BAK renamed OB : REFERENC. PRV 
OB:USERGUID.BAK renamed OB : USERGUID. PRV 

OA} RENAME 

* LETTER.TXT *.BAK 

OAzLETTER .TXT renamed OAiLETTER. BAK 

* MAXIMUMS.COM OPT*.* 
OArMAXIMUMS.COM renamed OA: OPTIMUMS. COM 

* [ RgTURN] 
OA} 



Invalid drive letter usage 
Invalid user number usage 
Destination drive read only 
<filename> rename to same filename 
<filename> read only 
File not found 
Invalid filename 1 
Invalid filename 2 
Insufficient memory 
Network error 
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RESET Command 



RESET allows one or more slave to be reset 
from another slave attached to the master. 



Syntax 



Explanation 



Examples 



Error Messages 



RESET s 



the 



slave 



where "s" is the letter 



The RESET command will reset 

processor "s", where "s" is 

for the slave. The RESET command can be used 

to reset more than one slave by entering a 

string of slave letters as the command tail, 

To reset all slaves, type in RESET * <cr>. 

RESET must be executed from the master. (See 
the MASTER command.) In systems with banked 
memory RESET must be run in bank 0. 



OAl RESET AC 

Resetting Slaves AC 

OAl RESET * 

Resetting Slaves ABCDEFGHIJKLMNOP 

OA) 



Non-privileged user 

You must attach to the master to use 

RESET 

Invalid slave letter 
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SEND Command 

Syntax 

Explanation 



Examples 



The SEND command lets you write a message to 
a FIFO. 



SEND filename message 



The "filename" argument specifies the FIFO to 
be read, and "message" is any text you wish. 
The SEND command is useful where FIFOs are 
used as batch queues or message mailboxes in 
a multi-user system. 

Any occurrence of the vertical bar I in the 
"message" argument is replaced by the charac- 
ter backslant \, which is helpful if you are 
sending a command string to a batch queue. 



OAI SEND BATCH. PQ D ELgTE *.gAK ;N 

Message sent to FIFO 

OAI SEND MAILBOX. EMK TED; NO DICE... RON 

Message sent to FIFO 

OA) 



Error Messages 



No FIFO file name specified 
FIFO file not found 
File not FIFO 
FIFO file full 



Patch Points 



I Z80 I 8086 I Val 



I 103H 
I 104H 
I 



Descr ipti o n 



CS+4 
CS+5 



II \ II 



Special delimiter 
Normal delimiter 
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SET Command The SET command lets you set and clear file 

attributes. 



Syntax 



SET filename ; options 
SET {; options} 



Explanation The SET command changes the attributes of the 

file specified by the "filename" argument as 
requested in "options". 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
attributes of multiple files are to changed. 

SET may also be used to set a drive read-only 
or read/write by specifying a "filename" 
consisting of a drive letter "d:" only. 

If you omit "filename" from the command 
(second form), then the SET command operates 
in an interactive mode. You are prompted by 
an asterisk * to enter a series of directives 
from the console. The syntax of each direc- 
tive is: 



filename {/options} 



Options specified within a directive take 
precedence over options specified in the SET 
command itself. A null directive (RETURN 
only) terminates the SET command. 
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Options 



Examples 



Error Messages 



Option 1 


Explanation 1 


;+A 


Set "archived" attribute 1 


;+F 


Set "FIFO" attribute 1 


;+G 


Set "global" attribute 1 


;+R 


Set "read-only" attribute 1 


;-A 


Clear "archived" attribute 1 


;~F 


Clear "FIFO" attribute 1 


;-G 


Clear "global" attribute 1 


;-R 


Clear "read-only" attribute 1 


;N 


If "filename" contains wild 1 




cards, SET does not ask you for 1 




confirmation before changing 1 




attributes of each file. 1 


;Y 


If "filename" contains wild 1 




cards, SET asks you for confir- 1 




mation before changing attri- 1 




butes of each file. 1 


OAlSET 


*.COM ;N +RG -A 1 


OArCOPY .COM set to RG 1 


OA:DELETE .COM set to RG 1 


OA: RENAME .COM set to RG 1 


OA}SET 


B: ;+R 1 


Drive B 


set to read-only 1 


OA}SET 


B; ;~R 1 


Drive B 


set to read/write 1 


OA} 






Destina 


1 
tion drive read only 1 


File not found 1 


Invalid 


filename 1 


Insufficient memory 1 


Network 


error 1 

1 
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SHOW Command The SHOW command lets you display the set- 
tings of file attributes. 



Syntax I 

I SHOW filename ; options 
I SHOW {; options} 



Explanation The SHOW command displays the attributes of 

the file specified by the "filename" argu- 
ment. 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
attributes of multiple files are to be dis- 
played. 

SHOW may also be used to display the status 
of a drive (read-only or read/write) by spe- 
cifying a "filename" consisting of a drive 
letter "d:" only. 

If you omit "filename" from the command 
(second form) , then the SHOW command operates 
in an interactive mode. You are prompted by 
an asterisk * to enter a series of directives 
from the console. The syntax of each direc- 
tive is: 



filename {;options} 



Options specified within a directive take 
precedence over options specified in the SHOW 
command itself. A null directive (RETURN 
only) terminates the SHOW command. 
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Options 



Examples 



Error Messages 



Option I 


Explanation 1 


;L 


SHOW prints the file attributes 1 




(rather than displaying them on 1 




the console) . 1 


;N 


If "filename" contains wild 1 




cards, SHOW does not ask you for 1 




confirmation before displaying I 




attributes of each file. 1 


;Y 


If "filename" contains wild 1 




cards, SHOW asks you for confir- 1 




mation before displaying the 1 




attributes of each file. I 


0A}SHOW 


*.COM jN 1 


OArCOPY .COM has attributes: AGR 1 


OA:DELETE .COM has attributes: AG 1 


OA:RENAME .COM has attributes: A 1 


OAISHOW 


B; 1 


Drive B 


is read-only 1 


0A}SHOW 


A; 1 


Drive A 


is read/write 1 


OA} 


1 


1 
File not found 1 


Invalid 


filename 1 


Insufficient memory 1 

1 
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TST490 Command 



TST490 is utility program for the 490- 
series hard disk controller and the cartridge 
module hard disk drive. 



Syntax 



Explanation 



TST490 



Commands 



TST490 is a utility program which allows the 
operator to exercise and test a cartridge- 
module hard disk drive and the controller. 

TST490 must be executed in a single-user 
configuration. In systems with banked 
memory, it must be run in bank 0. 

When TST490 is executed, it waits for a com- 
mand. Type HELP for a list of all of the 
commands. The INIT command must always be 
executed first. 



CYLINDER - Set the current cylinder 
number (0-822). Default = 0. 

DISKTEST [loop] [all] [all loop] - 

Performs a read-write-verify of 
each sector. [loop] will per- 
a continuous test until termin- 
ated with an ESC. [all] will 
test each sector on the drive 
(all surfaces, both volumes) . 
This test takes several hours 
to complete one cycle. 
WARNING - This test destroys the 
data on the disk. 
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Commands 
(Continued) 



DUMP [address] [BUF] [PAGE nl 
system memory or the 
memory of the control 
[addresslmay be any v 
address. [BUF] will 
controller memory. [ 
display any valid sys 
page (256 bytes) wher 
page number (0-255) . 
[address] are omitted 
will begin with page 



- Displays 
on board 
ler . 

alid hex 
display the 
PAGE] will 
tern memory 
e n is the 

If n or 
, the dump 
0. 



ENTER [address] - Enters values directly 
into system memory. If [address] 
is omitted, it starts at 0. A 
period is used to terminate 
ENTER. 

ERROR [error number] [ON] [OFF] [CLEAR] 
[ABORT] - Examine errors. [CLEAR] clears 
the error buffer. [error number] 
is the number of the error to be 
examined. Error logging is dis- 
abled with [OFF] and enable with 
[ON] . [ABORT] causes testing to 
stop if an error occurs. [ABORT] 
is reset by INIT. 

FILLBUF [byte] - Fills the controller 
memory with the constant hex 
[byte] . 

FILLMEM [byte] - Fills a section of 

memory with [byte] . The user is 
prompted for the starting and 
ending addresses. 
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Commands 
(Continued) 



FORMAT [all] [byte x] [all byte y] - 

formats the currently selected 
surface. FORMAT [all] formats 
all surfaces. FORMAT [byte x] 
sets the sector fill byte to the 
new value. [byte x] defaults to 
E5 hex. After formatting, veri- 
fication is performed. 

HEAD - Sets the head number. 

HELP - Displays menu of commands. 

iNIT - Initializes the program to 
default values. 

INIT [x] - Changes the interrupt vector 
used by the controller. x may be 
from to 7. Default is 4. 

IPL - Exits the program by executing 
Initial Program Loader 

QUIT - Exits the program by performing 
a warm boot. 

RAMBUF - Changes the address of the 
read/write buffers in system 
memory. 

JREAD [LOOP] [count] - Reads the current 
sector to the read buffer. If 
[count] is omitted, only 1 sector 
will be read, else [count] may be 
a decimal value from 1-127. 
READ [LOOP] repeatedly reads the 
current sector. 

j£ECTOR [sector number] - Sets the 

sector number in the range from 
- 31. Default = 0. 
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Commands 
(Continued) 



SEEKTEST [ loop] [all] [all loop] - 

Performs a seektest to each 
sector in the volume. [loop] 
is a continuous test terminated 
by ESC. [all] will check each 
sector on the drive (all sur- 
faces, both volumes) . 
SEEKTESTtakes several hoursto 
complete one cycle. 

TESTBUF - Tests the controller memory. 
The display can be frozen with 
control-S. 

TRANSFER - Changes the transfer mode 

(DMA or programmed I/O) between 
the controller and system RAM. 
Note that DMA is used only with 
disk read/writes; all other op- 
erations use programmed I/O. 

VERIFY - [all] [header] [hdr] [byte x] 

[all header] [all byte x] - 

Reads each sector on the selected 
surface. Each sector header is 
checked and the data bytes are 
checked to be E5 hex. [all] will 
test all surfaces on the drive, 
[header] or [hdr] will check only 
the headers. [byte x] will check 
for data [byte] instead of E5. 

i^OLUME - Sets the head number on the 
drive. Volume selects the 
removeable surface and volume 1 
selects the fixed surface(s). 
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Commands 
(Continued) 



WRITE [LOOP] [count] - 


Writes the data inl 


the wri 


te buff 


er out to the 


cur- 1 


rently 


selecte 


d sector. If 




[count] 


IS omi 


tted, only one 


sec- 1 


tor is 


written 


[count] may 


be 1 


a decimal valu 


e in the range 


of 1 


1-127. 


WRITE 


[LOOP] repeate 


dly 1 


writes 


the current sector. 




Warning 


- This 


command will 


des- 1 


troy th 


e data 


on the disk. 
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Syntax 



TSTF930 Command TSTF930 is a floppy disk utility used for 

testing IMS International 930 floppy control- 
lers, drives and floppy diskdettes. 



I I 

I TSTF930 I 

I I 



Explanation The TSTF93 command must be executed in a 

single-user configuration. In systems with 
banked memory, it must be run in bank 0. 

The TSTF930 program executes a number of 
commands which can be used to test your flop- 
py controller, drive or disks. To see a list 
of the commands, type HELP after starting the 
program. For an explanation of a certain 
command, type HELP command-name . If you are 
already in the HELP mode, you can type the 
commiand name for an explanation or press 
RETURN to exit. 
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TSTW Command 



TSTW is a utility program used to test 
Winchester drives. 



Syntax 



Explanation 



TSTW 



Commands 



TSTW is a utility program which allows the 
operator to exercise and test a Winchester 
disk. 

TSTW must be executed in a single-user 
configuration. In systems with banked 
memory, it must be run in bank 0. 

When TSTW is executed, you will be asked 
to enter the type of Winchester on your 
system. You will also be asked if your 
Winchester controller has a "fast-seek" 
interface card. This latter question is 
asked only if you entered a 5" Winchester on 
the first question. TSTW will then wait for 
a command. Type HELP for a list of all of 
the commands. The INIT command must always 
be executed first. 



CYLINDER - Set the current cylinder 
number. 

DISKTEST [LOOP] [ALL] [ALL LOOP] - 

Performs a read-write-verify of 
each sector. [LOOP] will per- 
a continuous test until termin- 
ated with an ESC. [ALL] will 
test each sector on the drive 
(all surfaces, both volumes) . 
This test takes several hours 
to complete one cycle. 
WARNING - This test destroys the 
data on the disk. 
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Commands 
(Continued) 



DUMP [address] [BUF] [PAGE n] - Displays 
system memory or the on board 
memory of the controller, 
[addresslmay be any valid hex 
address. [BUF] will display the 
controller memory. [PAGE] will 
display any valid system memory 
page (256 bytes) where n is the 
page number (0-255) . If no 
arguments are entered, DUMP will 
default to the Read/Write buffer 
address. 

ENTER [address] - Enters values directly 
into system memory. If [address] 
is omitted, it starts at 0. A 
period is used to terminate 
ENTER. 

ERROR [error number] [ON] [OFF] [CLEAR] 
[ABORT] - Examine errors. [CLEAR] clears 
the error buffer. [error number] 
is the number of the error to be 
examined. Error logging is dis- 
abled with [OFF] and enable with 
[ON] . [ABORT] causes testing to 
stop if an error occurs. [ABORT] 
is reset by INIT. 

FILLBUF [byte] - Fills the controller 
memory with the constant hex 
[byte] . 

FILLMEM [byte] - Fills a section of 

memory with [byte] . The user is 
prompted for the starting and 
ending addresses. 
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Commands 
(Continued) 



FORMAT [byte] - formats the entire 

disk. [byte] changes the current 
sector fill number. [byte] de- 
faults to E5H. 

HEAD - Sets the head number. 

XNIT - Initializes the program to 
default values. 

IPL - Exits the program by executing 
Initial Program Loader 

LDPATT - Loads the buffers with the 

"Neal pattern" and inserts a 16 
bit pattern [byte] [byte] in the 
middle. A prompt is issued for 
the pattern. Use this test only 
for ECC testing; it will destroy 
the header and data on the cur- 
rently selected sector. 

QUIT - Exits the program by performing 
a warm boot. 

RAMBUF - Changes the address of the 
read/write buffers in system 
memory. 

£EAD [LOOP] [count] - Reads the current 
sector to the read buffer. If 
[count] is omitted, only 1 sector 
will be read, else [count] may be 
a decimal value from 1-20. 
READ[LOOP] repeatedly reads the 
current sector. 

RECTOR [sector number] - Sets the 
sector number. 
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Commands 
(Continued) 



SEEKTEST [LOOP] - 

Performs a seektest to each 
sector in the volume. [LOOP] 
is a continuous test terminated 
by ESC. SEEKTEST takesseveral 
hours to complete one cycle. 

SEEKVER [ON] [OFF] - Enables/disables 
seek verification. 

TESTBUF - Tests the controller memory. 
The display can be frozen with 
control-S. 

TESTECC [LOOP] - Executes an error 

checking and correcting test. 
[LOOP] will run the test until 
terminated with ESC. Run time 
is approximately one minute. 

VERIFY - [HEADER] [HDR] [byte] - 

Reads each sector on the selected 
surface. Each sector header is 
checked and the data bytes are 
checked to be E5 hex. [HEADER] 
or [HDR] will check only the 
headers. [byte] will check for 
data [byte] instead of E5 . 

WRITE [LOOP] [count] - Writes the data in 
the write buffer out to the cur- 
rently selected sector. If 
[count] is omitted, only one sec- 
tor is written. [count] may be 
a decimal value in the range of 
1-20. WRITE [LOOP] repeatedly 
writes the current sector. 
Warning - This command will des- 
troy the data on the disk. 
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TSTWIN Command TSTWIN is an IMS Winchester test utility used 

for testing IMS Winchester drives with IMS 
model 1100 DMA Winchester controllers. To 
use this utility it must be run on a single- 
user system and the Winchester drive(s) must 
have been previously formatted by the FMTWIN 
Format utility. 



Syntax 



TSTWIN 



Explanation The program will sign on and display a status 

screen. The status information displayed on 
the screen indicates the following: 

UNIT: the physical unit number of the drive 

(displayed in decimal) . 

TRACK: the current track location of the 

drive (displayed in decimal) . 

SECTOR: the current sector location of the 

drive (displayed in decimal) . 

STATUS: the current status condition of the 

drive (status conditions are defined in "help 

menu"). (Displayed in hex.) 

PROG ID: the name of the utility. 

TEST COUNTER: this counter is only used 

during the "READTEST" and 

"WRITETEST" commands. The first byte 

indicates how many cycles the test has 

completed. The last 3 bytes indicate a count 

of the number of read or read/write 

operations during the execution of the test 

(displayed in hex) . 

REV: the revision number of the utility 

(displayed in decimal) . 

DMA READ ADDRESS: the address in RAM where 

disk data is transferred TO during a read 

(displayed in hex) . 

DMA WRITE ADDRESS: the address in RAM where 

disk data is transferred FROM during a write. 

(displayed in hex) 
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Explanation FREE MEMORY: the "from-to" addresses of RAM 

(Continued) not taken up by TSTWIN or the Operating 

system (displayed in hex) . 

NO.OF TRACKS: the number of tracks contained 
on the drive. (displayed in decimal) 
ERROR COUNTER: the number of errors 

accumulated during program usage. (displayed 
in decimal) 

Most of the commands do not alter data on the 
Winchester. However, there are 3 destructive 
commands. They are "WRITE", "WRITERES", and 
"WRITETEST". 

The "WRITE" and "WRITERES" commands will 
write data from the DMA write buffer to one 
or more sectors or to a full track. Track 0, 
sectors 0-4, and the last 8 tracks of IMS 
Winchesters are "reserved" areas for 
controller firmware and Operating System 
usage. The "WRITERES" command is used to 
write to the reserved areas, and the "WRITE" 
command is used to write to all other areas. 
The "WRITETEST" command will execute a 
destructive read/write test of every sector 
on the Winchester. (Except the reserved 
areas) . 

The "RETRIES" command, although not 
destructive, should be used with caution as 
it can affect the performance of the 
Winchester. The Winchester controller 
firmware is initialized to do 5 retries on a 
read or write request before it interprets an 
error. The "RETRIES" command allows the user 
to temporarily change the number of retries 
done by the firmware. Changing the number of 
retries to or 1 will disable the ECC error 
correction. The "QUIT" command will set 
retries back to 5 when exiting the program. 
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Explanation The "RETRIES" command is useful for finding 
(Continued) soft errors on Winchesters. For example, to 

locate potentially bad sectors, retries could 
be set to and extended "READTEST"s or 
"WRITETEST"s could be run. Bad sectors found 
in this manner could then be assigned to the 
alternate sector table on the drive with the 
FMTWIN utility (if re-formatting the drive) 
or the ALTSEC utility. 
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TYPE Command 

Syntax 

Explanation 



The TYPE command displays the contents of a 
text file on the console or printer. 



TYPE filename {; options} 



The TYPE command displays the contents of the 
text file specified by "filename". The 
result may be directed to either the console 
or printer. 



Options 



I Opt io n I. 



E xpla n ation 



;L 



The file is printed, rather than 
displayed on the console. 



Example 



OA} TYPE B;UPDATE.DOC 
...(display of B:UPDATE.DOC) 
OA) 



Error Messages 



File not found 
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VERIFY Command 



Syntax 



Explanation 



Options 



Example 



The VERIFY command scans a disk for bad 
blocks, and (optionally) marks them so that 
TurboDOS will avoid using them. 



I 

I VERIFY d: {; options) 



The VERIFY command reads every block on the 
disk identified by "d:", which must be at- 
tached to the processor in which the command 
is executed. If bad blocks are detected, 
VERIFY will tell you how many of them were 
encountered, and will ask you whether you 
want them marked. If you answer "yes", then 
VERIFY will create a read-only directory 
entry under the name BLOCKS. BAD to reserve 
the defective blocks and prevent their subse- 
quent use by TurboDOS. Use of the VERIFY 
command is restricted to privileged log-ons 
only. 



Option 



Explanation 



;R VERIFY repeats continuously 

(allowing multiple disks to be 
verified) until terminated by 
typing CTRL-C. 



OAl VERIFY B; 

Insert disk to be verified in drive B 
Enter <CR> to begin verifying: [RETURN] 
Verifying blocks on drive: B 

Verify completed - 3 bad blocks found 
Mark bad blocks in directory (y/n)? Y 
Marking bad blocks in directory 
OA) 
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Error Messages 



Non-privileged user 
Unable to execute from 


bank 


1 

1 

1 1 


No verify 
Unable to 


drive specif 
lockout veri 


Led 1 
Ey drive 1 


Verify drive not ready 
Insufficient memory to 
Excessive bad blocks 


veri 


fy 1 


Error marking bad bloc 
Bad directory block 


ks 
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WALT Command WALT is a Winchester alternate sector 

utility. 



Syntax 



WALT {d:} 



Explanation WALT provides the capability to create and 

maintain the Alternate Sector Table entries, 
the BLOCKS. BAD directory entries, and the 
Load Parameter Block (LPB) . 

WALT will only run in a single-user 
configuration. In systems with banked 
memory, WALT must be run in bank 0. 

The WALT command uses questions and menus to 
quide the user through the program. 

The Winchester driver makes use of an Alter- 
nate Sector Table which is located on the 
first physical sector of the disk drive and 
set up by the Winchester format program, 
FMTW. The fonaat. is a four byte entry for 
track enc sector of each bad sector requiring 
an alternate. Unused entries have a track 
number of OFFFFH. The Winchester driver 
assumes that if the first drive has more bad 
sectors than are on track 2 (17 or 18) , then 
BLOCKS. BAD directory entries can be used to 
prevent the system from accessing those sec- 
tors. 

When changes are made to the Alternate Sector 
Table (which is read into a buffer) , WALT 
will prompt the user to write out sector 
before exiting. Since Alternate Sector Table 
changes are only made in memory buffers, they 
will have no effect if sector is not writ- 
ten out. 
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Explanation 
(Continued) 



The Verify Disk function in 
mode will sequentially read al 
from the tracks specified, wh 
that the headers and ECC bytes a 
Verify Read and Write function 
data because it writes a patte 
then reads and verifies all the 
the tracks specified. If an 
the user is given several opti 
elude making an Alternate Sect 
BLOCKS. BAD directory entry. 



the Read Only 
1 the sectors 
ich verifies 
re good. The 
will destroy 
rn of E5H and 
sectors on 
error occurs, 
ons which in~ 
or Table or a 



During any attempt 
directory entry, the 
logical drive is sea 
ber specified. If th 
directory, the operat 
file it was found in 
directory entry is 
desires, he can stop 
system command £ to 
wishes and then re 
BLOCKS. BAD directory 



to create a BLOCKS. BAD 
entire directory for the 
rched for the block num- 
e block is found in a 
or is informed of which 
and the new BLOCKS. BAD 

not made. If the user 
(ST) the program and use 

(lijeie the file if he 
call WALT to add the 
entry. 
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XON Command 



The XON command lets you enable or disable 
the protocol handling for any serial port. 



Syntax 



Explanation 



XON {channel*} (setting) 



In order to run WordStar on an XON/XOFF 
terminal, the serial driver must be told to 
ignore ''S and ''Q instead of using them to 
stop and re-start the flow of characters to 
the terminal. Before running WordStar, type: 



re-enable XON/XOFF 



XON {channel*} OFF 

After running WordStar, 
protocol by typing: 

XON {channel*} ON 



The channel* can be any channel from to 15, 
inclusive. If you omit the channel*, it 
will default to 0, which is the default 
Console Channel. 

If you omit the setting, it will default to 
ON. 



Examples 



0A}XON 

XON: Channel has Protocol Handling 

turned ON 
0A}XON 15 OFF 
XON: Channel 15 has Protocol Handling 

turned OFF 
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Error Messages 



XON: we can't run in Bank 1. Please 

change to Bank 0. 
XON: No such channel number. Try 

through 15 (decimal) . 



Patch Points 



None- 
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8086 family: A family of compatible 16-bit microprocessors de- 
signed by Intel Corporation, which include the 8086, 8088, 80186 
and 80286. 

abort: Premature termination of a program at your request. 
TurboDOS provides a special attention sequence which enables you 
to abort a program at any time. 

allocation map: The area on a disk where TurboDOS keeps track of 
which portions of the disk storage space are occupied with infor- 
mation, and which portions are free. 

application program: Computer program designed for a particular 
application, such as word processing, data management, accoun- 
ting, spreadsheet calculations, or statistical analysis. 

archived attribute: An file attribute which indicates that a 
file has not been changed since the last time it was backed up, 
and therefore does not have to be backed up again. 

argument: Variable item in a command which is passed to the 
command program. Arguments may specify a drive, a file name, a 
command option, etc. 

ASCII: American Standard Code for Information Exchange is a code 
used to represent textual information in computers. ASCII de- 
fines a standard representation for each letter, digit, and 
punctuation character as a 7-bit binary number. 

attention request: A means for interrupting the execution of the 
program in progress in order to make a request of TurboDOS. In 
most systems, you issue an attention request by keying either 
CTRL-S or CTRL-@. 

attribute: A file characteristic that you can set or clear. 
TurboDOS supports four attributes: archived, read-only, global, 
and FIFO. 

autoload: A facility which allows a program or command sequence 
to be executed automatically without explicit user action. 
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automatic spooling: A printing method in which print output is 
first accumulated in a disk file, then automatically queued for 
background printing. 

backspace: A key on most console keyboards used to correct 
typing errors by deleting incorrect keystrokes. 

backup: Copy of a file or disk made to protect against loss in 
case of human error or equipment failure. Also, the act of 
making such backup copies. 

bad block: Spot on a disk which is defective and unusable. 
TurboDOS allows such bad blocks to be detected, marked, and 
avoided. 

banked memory: A hardware technique in which multiple memory 
banks are installed in a microcomputer, together with a mechanism 
for switching from one bank to another under software control. 
This approach is commonly used to allow more than 64K of memory 
to be used with an 8-bit microprocessor such as the Z80. 

batch processing: Processing under the control of a pre-defined 
sequence of commands (see "do-file"). 

bit: Short for "binary digit" which can take the values or 1, 
the smallest unit of information. (See "byte", "kilobyte", and 
"megabyte" . ) 

boot tracks: See "reserved tracks". 

buffer: An area of memory used to hold data temporarily during 
processing. TurboDOS provides an elaborate disk buffer facility 
in order to speed performance by reducing the frequency of disk 
accesses. 

byte: Basic unit of information, consisting of 8 bits. A byte 
of information can represent one ASCII character, or an integer 
between and 255. (See "bit", "kilobyte", and "megabyte".) 

cold start: Initial start-up of TurboDOS, which involves reading 
a copy of the TurboDOS operating system from disk into the compu- 
ter's memory. 
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command: An instruction you give to TurboDOS, telling it to run 
a particular program. Also, any of the more than 30 standard 
programs furnished with the TurboDOS operating system. 

command prompt: A symbol (e.g., "OA}") displayed on your console 
to indicate that TurboDOS is ready to accept a command. The 
command prompt consists of the current user number (e.g., "0"), 
the current drive letter (e.g., "A"), and the character "}". 

command string: A sequence of TurboDOS commands that you key in 
together on a single line. The commands in a command string must 
be separated by the backslant \ character. 

command tail: Arguments which follow the program name in a 
command. TurboDOS passes the command tail to the program. 

confirmation: Feature of various TurboDOS commands that allows 
you to approve or cancel each file operation before it is done. 

console: Hardware device that allows you to interact with your 
computer, usually consisting of a keyboard and a display screen. 

CP/M: Short for "Control Program/Microcomputers", a widely-used 
operating system for single-user microcomputer systems. CP/M is 
a registered trademark of Digital Research Inc. 

CTRL: A special key on most console keyboards for entering non- 
printing control characters. To enter the character "CTRL-X", 
you have to hold down the CTRL key while you press X. 

current drive: The disk drive which is used by default whenever 
you don't specify any drive explicitly. 

cursor: An indicator on your console screen (usually a box or 
underline) which shows you where the next character you type will 
appear. 

data: Any kind of information (numbers, text, formulas, pic- 
tures, etc.) that may be used as input to or output from a 
computer program. 

default: The value assumed by TurboDOS implicitly when you do 
not specify an argument explicitly. 
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delimiter: Character that separates one argument or command from 
another. 

de-spooling: Background printing from a print file on disk. 

diagnostic: A message displayed on your console to tell you that 
a processing error has occurred, and often prompting you to 
choose among alternative methods of recovering from the error. 

direct printing: Routing of print output directly to a printer 
on a character-by-character basis. (See "spooling".) 

directory: A table of contents maintained by TurboDOS on each 
disk to keep track of files stored on the disk. 

disk: A rotating magnetic medium used by computer systems to 
store programs and data. (See "floppy disk" and "hard disk".) 

diskette: See "floppy disk". 

do-file: A file containing a pre-defined sequence of TurboDOS 
commands. (See "batch processing"). 

drive: A hardware device which reads and writes on magnetic 
disks, (much as a tape recorder records and plays magnetic tape). 
TurboDOS identifies each drive with a letter between A and P. 

dump: A display or printout of information consisting of the 
hexadecimal representation of each byte of data. (See "hexadeci- 
mal") . 

echo-print: A mode in which every character displayed on the 
console is also echoed to the printer. 

FIFO: Short for "first-in, first-out". A special kind of file 
in which data is always written to the end but read from the 
beginning. FIFOs are used mostly for inter-processor and inter- 
user communications. 

FIFO attribute: File attribute which designates that a file is 
to be accessed using the special FIFO access method. 
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file: Collection of related information stored on disk. Files 
may contain programs or data. 

file attribute: See "attribute". 

file lock: Mechanism to prevent several users from trying to 
access or modify a file at the same time. 

file name: The name you assign to a file so that you can identi- 
fy it later. TurboDOS keeps track of your files by name. 

file type: An optional extension to a file name used to group 
similar files together. 

floppy disk: Inexpensive removable disks which use a flexible 
magnetic medium that spins inside a cardboard jacket. Floppy 
disks come in 8-inch and 5.25-inch diameter sizes (smaller ones 
are being introduced). They may be recorded on one or both 
sides, and commonly have capacities of 150 to 1,500 kilobytes. 

format: The way in which data on disk is organized into tracks 
and sectors. Also, the process of initializing a disk with the 
desired format. 

global attribute: File attribute which designates that a file 
saved under user number is to be accessible from any user 
number. Global files provide a convenient way to make selected 
files available to all users. For example, TurboDOS commands and 
other common programs are often given the global attribute. 

hard disk: High-performance disks which use one or several rigid 
magnetic platters which spin inside a sealed chamber. Hard disks 
offer much greater storage capacity than floppy disks, typically 
5 to 50 megabytes or more. 

hard sectored: Disk whose format is fixed by the hardware 
itself. 

hardware: Physical equipment comprising a computer system (as 
distinguished from the programs that run on it). 
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hashed directory: A directory format that uses a sophisticated 
technique to make directory look-up much faster than possible 
with a linear directory. Hashed directories are especially 
suited for use on hard disks with big directories. 

hexadecimal: Numeric notation using base 16, which is often a 
convenient way to represent non-textual information. The sixteen 
hexadecimal digits are represented by the characters 0-9 and A-F. 

incremental backup: An efficient backup procedure whereby backup 
copies are made only of files which have been created or modified 
since the last backup cycle. (See "archived attribute".) 

kilobyte: Unit of information consisting of 1,024 bytes and 
abbreviated by the letter "K". Each page of this document con- 
tains about 3K of information. (See "byte".) 

linear directory: A simple directory format compatible with CP/M 
and suitable for use on floppy disks. (See "hashed directory".) 

local command: A command which requires direct access to disk 
drive and controller hardware, and consequently may be executed 
only in the processor to which the disk is attached. 

log-off: Procedure for terminating a console session on a multi- 
user system. After log-off, a log-on is required before your 
console can be used again. (See "log-on".) 

log-on: Procedure for starting a console session on a multi-user 
system. You must identify yourself by entering your user-id and 
possibly a security password before TurboDOS will allow you to 
make use of the computer. 

loosely-coupled network: Multi-processor system in which the 
various processors are physically separated (often built into 
user consoles), and connected with some sort of communications 
path. 

manual queuing: Submitting files for background printing by 
using the QUEUE command. 
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manual spooling: A printing method in which print output is 
accumulated in a disk file, but rLQ.L automatically queued for 
background printing. 

master processor: In a networking system, a processor whose 
primary function is to manage disk drives, printers, and other 
shared peripherals on behalf of other (slave) processors. 

megabyte: Unit of information consisting of 1,024 kilobytes 
(1,048,576 bytes). The entire set of TurboDOS manuals contains 
roughly a megabyte of information. (See "byte" and "kilobyte".) 

memory: Hardware in a computer system which stores information. 
(See "random-access memory".) 

MP/M: Multi-user version of the CP/M operating system, which 
uses time-sharing to support multiple users. MP/M is a regis- 
tered trademark of Digital Research Inc. (See "CP/M", "time- 
sharing" .) 

multi-processor: System composed of several microcomputers net- 
worked together. (See "microprocessor", "networking".) 

multi-user: System capable of supporting several user activities 
at several consoles simultaneously. (See "networking", "time- 
sharing" . ) 

nested do-file: A do-file executed from within another do-file. 

networking: Coordinating a system of interconnected microcompu- 
ters. Generally, a separate microcomputer supports each user 
console. One or more additional microcomputers manage the disks, 
printers, and other shared devices of the system. 

operating system: A program which supervises the operation of 
application programs, and which manages memory, disk drives, 
consoles, printers, and other hardware resources of a computer 
system. TurboDOS is an operating system. 

parameter: A place-marker in a do-file that indicates where a 
variable argument is to be substituted when the do-file is exe- 
cuted. (See "argument", "do-file". ) 
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password: A security code used to validate a user-id during the 
log-on procedure. (See "log-on", "user-id".) 

peripheral device: A hardware device attached to a microcomputer 
for purposes of input or output of information. Typical peri- 
pheral devices include disk drives, consoles and printers. 

print job: A unit of printed output, generally the output pro- 
duced by one application program. 

print queue: A list of print jobs to be printed in the back- 
ground. 

printer: Hardware device that produces printed hardcopy of tex- 
tual information. 

privileged log-on: A user who has logged-on successfully to a 
privileged user-id, enabling him to access various protected 
commands and features of TurboDOS. 

program: Instructions for performing a processing task, coded so 
that they can be interpreted by the computer hardware. 

prompt: Symbol displayed on the console by a program to advise 
you what to do next. 

queue: See "print queue". 

random-access memory (RAM): The primary high-speed memory of a 
microcomputer, used to hold programs in execution and data being 
processed. 

read-af ter-write: When writing data to disk, immediately reading 
it back to make sure it was recorded properly. 

read-only attribute: File attribute which designates that a file 
may be read but not modified or deleted. This helps you protect 
important files against accidental distruction. A drive may also 
be set read-only. 

record: Grouping of related data within a file. In TurboDOS, 
often refers to a block of data 128-bytes long. 
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record lock: Mechanism to prevent several users from trying to 
access or modify the same record of a file at the same time. 

recovery: Procedure to restart processing after encountering an 
error. 

remote console: Using a console attached to a slave processor to 
control activities in a master processor. 

reserved tracks: Designated tracks on a disk required by certain 
hardware configurations to support system start-up, and not 
otherwise used by TurboDOS. 

sector: Portion of a track on disk. A disk is formatted into a 
fixed number of sectors per track. 

server processor: See "master processor". 

slave processor: In a networking system, a processor whose 
primary function is to interact with a console and run applica- 
tion programs. (See "master processor".) 

soft sectored: Disk whose format is determined by pre-recording 
formatting information onto the disk. 

software: Computer programs (as distinguished from the hardware 
they run on) . 

spooling: Routing of print output to a disk file, instead of 
directly to a printer. (See "de-spooling", "direct printing".) 

syntax: Format for entering a given command. 

tightly-coupled network: Multi-processor system in which the 
various processors are co-located. (See "loosely-coupled net- 
work".) 

time-sharing: Technique for supporting multiple users with one 
microprocessor, whereby the processing time of the single proces- 
sor is shared among the various users. 

track: Concentric ring on a disk, upon which data is magnetical- 
ly recorded. A track is subdivided into sectors. 



A- 9 



TurboDOS 1.4 GLOSSARY 

User's Guide (Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

transient program area (TPA) : Memory space available to run 
commands and application programs. 

user-id: Identification of an authorized user, used for security 
purposes on a multi-user system. 

user number: Number from to 31 assigned to a file which it is 
created. User numbers can be used to organize files into sepa- 
rate libraries. 

volume label: The name you assign to a particular disk. 

warm start: Termination of a command or application program. 

wild card: Special characters (? and *) used in a file name to 
match any character in the corresponding position. 

Winchester disk: A non-removable form of hard disk, in which 
rigid magnetic platters spin inside of a hermetically sealed 
vessel to ensure freedom from contamination. 

word processor: An application program designed for composing, 
editing, printing, and otherwise manipulating text. 

Z80: An 8-bit microprocessor created by Zilog, Inc. 
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8086 microprocessor, 1-5, 4-12 



abort request, 1-11 
activity (log-on), 1-7, 5-46 
allocation map, 2-16, 5-35 
ALTSEC Command, 5-2 
archived attribute, 2-24, 

5-17, 5-65 
ASCII file dump, 5-30 
attention request, 1-11, 3-3, 

5-33, 5-48 
attribute 

archived, 2-24, 
5-17, 5-65 

FIFO, 2-24, 5-65 

global, 2-23, 5-65 

read-only, 2-23, 5-65 
attributes, 2-23, 5-64 
autoload facility, 4-7, 
AUTOLOAD command, 4-7, 5-4 
automatic spooling, 3-6 

BACKSPACE key, 1-10 
backup, 2-9, 2-24 



bad blocks, 5-85 

BANK command, 5-6 

banked memory, 1-5, 4-11, 5-6 

BATCH command, 5-7 

batch processing, 4-3 

batch queue, 5-7 

BLOCKS. BAD, 5-85 

BOOT command, 2-16, 4-8, 4-12, 

5-9 
boot tracks, 2-16, 5-9 
BUFFERS command, 5-11 



CHANGE command, 2-19, 5-13 
CLOCK Command, 5-14 
cold start, 1-6, 4-7 
COLDSTRT.AUT, 4-7 
command 

format, 1-8 

prompt, 1-6, 1-7 

processing, 4-1 

strings, 1-9, 4-2 

syntax, 1-8, 5-1 

tail, 4-1 
commands, 1-8 
commands 

simple, 4-1 

local, 4-8 
compatibility, 1-2 
confirmation 

in COPY, 5-16 

in DELETE, 5-23 

in QUEUE, 5-57 

in RENAME, 5-6 

in SET, 5-64 

in SHOW, 5-66 
console 

input from do-file, 4-4, 
5-27 

printing to, 3-7, 5-50 

remote, 4-9, 5-40 
COPY command, 2-7, 2-11, 2-22, 

5-16 
COPYF command, 2-9, 2-10, 5-20 
CP/M, 1-2 
CTRL-H, 1-10 
CTRL-U, 1-10 
CTRL-X, 1-10 
current drive, 2-5, 2-6 
cursor, 1-10 
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date, 1-7, 5-22 
DATE command, 5-22 
de-spooling, 1-4, 3-2, 3-5, 

3-9, 5-52 
DEL key, 1-10 
DELETE command, 2-8, 5-23 
diagnostic message, 1-4 
DIR command, 2-3, 2-18, 5-25 
direct printing, 3-1, 3-6, 

directory 

disk, 2-3, 2-17 

display, 5-25 

hashed, 2-18, 5-33, 5-34 

linear, 2-18, 5-33, 5-34 
disk, 2-1 
disk 

capacity, 1-3 

directory, 2-3, 2-17, 5-25 

errors, 2-19 

formats, 2-13 

organization, 2-16 

floppy, 1-3, 2-11 

hard, 1-3, 2-11 

reserved tracks, 5-9 
DO command, 4-3, 5-27 
do-file, 4-3, 5-27 
do-files 

console input, 4-4, 5-27 

nested, 4-6, 5-27 

parameters, 4-5, 5-28 
DRIVE command, 2-17, 5-29 
drive 

current, 2-5 

read-only, 2-24, 5-65 

search, 2-25 

selection, 2-5 
DUMP command, 5-3 



echo-print request, 1-11 

editor, 2-6 

end-print request, 1-11, 3-3 

ERASEDIR command, 2-15, 2-18, 
5-31 

errors 

correcting keyboard, 1-10 
disk read and write, 2-19 
spooler, 3-11 

exclusive sharing, 2-26 

FIFO 

as batch queue, 5-7 

attribute, 2-24, 5-65 

files, 5-32, 5-63 
FIFO command, 5-3 2 
file 

attribute, 2-23, 5-64, 5-66 

lock, 2-26 

name, 2-2 

searches, 2-25 

sharing, 2-26 

type, 2-2 
files, 2-1 
files 

copying, 2-7 

creating, 2-6 

deleting, 2-8 

renaming, 2-8 
FIXDIR command, 2-17, 2-18, 

5-33 
FIXMAP command, 2-16, 5-35 
floppy disk, 1-3, 2-11 
FMTF command, 5-37 
FMTW command, 5-40 
FMTWIN command, 5-42 
format of disk, 2-13 

global attribute, 2-23, 5-65 
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hard disk, 1-3, 2-11 
hard-sectored, 2-13 
hardware, 1-5 
hashed directory, 2-18, 5-31, 

5-33 
hexadecimal file dump, 5-30 

incremental backup, 2-24 

kilobyte, 1-5, 2-3 

LABEL command, 2-15, 2-16, 

5-44 
linear directory, 2-18, 5-33, 

5-33 
local command, 4-8 
lock 

file, 2-26 
record, 2-26 
log-on, 1-6, 1-7 
LOGOFF command, 5-45 
LOGON command, 4-7, 5-46 
loosely-coupled network, 1-5 



manual queuing, 3-4, 3-8, 5-53 
manual spooling, 3-4, 3-7 
map (allocation), 2-16, 2-17 
MASTER command, 4-9, 5-48 
master processor, 5-48 
megabyte, 1-5 
memory banks, 4-11 
memory management, 4-9 
memory size, 1-5 
MP/M, 1-2 

multi-processor, 1-5 
nested do-files, 4-6, 5-27 
networking, 1-2, 1-5, 4-8 
non-banked memory, 4-10 
not ready error, 2^20 

offline (printing to) , 3-7 
operating system, 1-1 



parameters in do-files, 4-5 
password, 1-7, 5-46 
performance, 1-3 
permissive sharing, 2-26 
PRINT command, 3-6, 5-50 
print 

job, 3-3, 3-10 

queue, 1-4, 4-4 

routing, 3-6, 5-50 

spooling, 1-4 
PRINTER command, 3-9, 5-52 
printing 

methods, 3-1 

direct, 3-1, 3-6 

spooled, 3-2 

to console, 3-7 

to offline, 3-7 
privileged log-on, 2-22, 5-46 
processing 

batch, 4-3 

command, 4-1 
prompt, 1-6 
PRTWIN command, 5-54 
PUTLDR command, 5-56 
queue 

assignment, 3-9, 5-52 

print, 1-4, 3-3 
QUEUE command, 3-8, 5-53 
queuing manually, 3-4, 3-8, 
5-53 

random-access memory, 4-9 
read error, 2-19 

read-af ter-write, 1-3 
read-only attribute, 2-23, 
read-only drive, 2-24, 5-65 
RECEIVE command, 5-59 
record locks, 2-26 
recovery options, 1-4, 2-19 
reliability, 1-3 
remote console, 4-9, 5-48 
RENAME command, 2-8, 5-60 
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organization of disk, 2-14 

search drive, 2-25 
searching for files, 2-25 
SEND command, 5-63 
server processor, 5-48 
SET command, 2-23, 5-64 
sharing files, 2-26 
SHOW command, 5-66 
sign-on, 1-6 

single processor system, 1-5 
slave processor, 5-48 
soft-sectored, 2-12 
spooling, 1-4, 3-2 
spooling 

automatic, 3-6 

errors, 3-11 

manual, 3-4, 3-7 
strings of commands, 4-2 
SYSLOG.SYS, 5-45, 5-47 

tightly-coupled network, 1-5 
time, 1-7, 5-22, 5-47 
time-sharing, 1-2, 1-5 
transient program area (TPA) , 

4-9, 4-10, 4-11, 4-12 
TST490 command, 5-68 
TSTF93 command, 5-73 
TSTW command, 5-74 
TSTWIN command, 5-7 8 
TYPE command, 5-81 



reserved tracks, 2-16, 5-9 

RESET command, 5-62 

user-id, 1-7 

user number, 2-21, 5-1 

user number 

copy to/from different, 5-16 
directory of different, 5-24 

USERID.SYS, 5-45, 5-46 



VERIFY command, 4-8, 4-12, 

5-82 
volume label, 2-16, 2-17, 5- 
WALT command, 5-84 
warm start, 4-7 
WARMSTRT.AUT, 4-7, 5-47 
wild card characters, 2-4, 

2-7, 2-8, 2-18, 5-16, 

5-23, 5-57, 5-60, 

5-64, 5-66 
Winchester disk, 2-13 
word processor, 2-6 
write error, 2-19 

Z80 microprocessor, 1-5 
Z80 memory 

non-banked, 4-10 

banked, 4-11 
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AUTOLOAD 
BANK 
BATCH 
BOOT 
♦BUFFERS 

CHANGE 
♦CLOCK 



COPY 



♦COPYF 
DATE 
DELETE 

DIR 

DO 
DRIVE 



command 

bank number 

command-string 

source destination 

(Nnn Sss) 
nn - number 
ss - size 

drive-list 

; option 

M - Military time 

R - Read and siplay 

date and time 
S - Set time 
V - View always 

source dest ; options 
A - archived only 
B - multi-disk files 
C - change media 
E - erase 
R - replace files 
Snn - source user # 
X - non-existibg 
Y/N - confirm 

source: dest: 

(SET) 

file ;option 
Y/N - confirm 

file ;option 
Y/N - confirm 
L - print 

filename (arg-list) 

drive ;option 
L - print 



DUMP 

ERASEDIR 

FIFO 

FIXDIR 

FIXMAP 

FMTF 



♦FMTW 
LABEL 
LOGOFF 
LOGON 
MASTER 
PRINT 



PRINTER 



filename ; option 
L - print 

drive: 

filename 

drive: 

drive: 

drive: ;option 
C - CP/M sectors 
T - TurboDOS sectors 
S - single-density 
D - double-density 

1 - single-sided 

2 - double-sided 
V - Verify only 
4-40 cylinders (5") 
8-80 cylinders (5") 

drive: 

label-name 



(key-1. . . key-n) 

C(ONSOLE) 

D(RIVE)=drive letter 

F(ILE) 

0(FF) 

P(RINTER) 

Q(UEUE)=queue letter 

letter (key-1. ..key-n) 
B(EGIN) 
G(0) 

0(FFLINE 

Q(UEUE)=queue letter 
S(TOP) 
T(ERMINATE) 
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PUTLDR source: dest: 

QUEUE filename ; option 
D - delete 
Q = queue letter 
S - save 
Y/N - confirm 



SHOW 

**TST490 
**TSTF930 



filename ; options 
L - print 
y/N - confirm 



(N) 

N - no help messages 



RECEIVE 


filename 




loaded 


RENAME 


old new ; option 
Y/N - confirm 


**TSTW 








TYPE 


filename ; option 


**RESET 


slavelist 




L - print 


SEND 


filename message 


VERIFY 


drive: ;option 
R - repeat 


SET 


filename ; option 








+/-A - archived 


**WALT 


drive: 




+/-F - fifo 








+/-G - global 








+/-R - read only 








Y/N - confirm 







ie zz 



Attach to the MASTER processor to use. 

In systems with banked memory, run in bank 



** - 



Run in a single-user system 



